mcpdrift-cli 1.0.0

package/dist/cli.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,23 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import type { FailureCategory } from './types.js';
+export declare function parseCommand(commandStr: string): {
+    command: string;
+    args: string[];
+};
+/**
+ * Redacts likely credentials, tokens, and secrets from stderr logs
+ */
+export declare function sanitizeStderr(rawStderr: string): string;
+export declare class McpClientError extends Error {
+    category: FailureCategory;
+    constructor(message: string, category: FailureCategory);
+}
+export interface McpSession {
+    client: Client;
+    transport: StdioClientTransport;
+    close: () => Promise<void>;
+}
+export declare function createMcpSession(serverCommand: string, env?: Record<string, string>, timeoutMs?: number): Promise<McpSession>;
+export declare function executeToolWithTimeout(client: Client, toolName: string, args?: Record<string, unknown>, timeoutMs?: number): Promise<unknown>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAiCpF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,EAAE,eAAe,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe;CAKvD;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,oBAAoB,CAAC;IAChC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,wBAAsB,gBAAgB,CACpC,aAAa,EAAE,MAAM,EACrB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,SAAS,GAAE,MAAc,GACxB,OAAO,CAAC,UAAU,CAAC,CAoGrB;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAClC,SAAS,GAAE,MAAc,GACxB,OAAO,CAAC,OAAO,CAAC,CAclB"}

package/dist/client.js

@@ -0,0 +1,148 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+export function parseCommand(commandStr) {
+    const tokens = [];
+    let current = '';
+    let inDouble = false;
+    let inSingle = false;
+    for (let i = 0; i < commandStr.length; i++) {
+        const char = commandStr[i];
+        if (char === '"' && !inSingle) {
+            inDouble = !inDouble;
+        }
+        else if (char === "'" && !inDouble) {
+            inSingle = !inSingle;
+        }
+        else if (/\s/.test(char) && !inDouble && !inSingle) {
+            if (current.length > 0) {
+                tokens.push(current);
+                current = '';
+            }
+        }
+        else {
+            current += char;
+        }
+    }
+    if (current.length > 0) {
+        tokens.push(current);
+    }
+    if (tokens.length === 0) {
+        throw new Error('serverCommand cannot be empty.');
+    }
+    return {
+        command: tokens[0],
+        args: tokens.slice(1),
+    };
+}
+/**
+ * Redacts likely credentials, tokens, and secrets from stderr logs
+ */
+export function sanitizeStderr(rawStderr) {
+    if (!rawStderr)
+        return '';
+    return rawStderr
+        .replace(/(Bearer\s+)[A-Za-z0-9_\-\.\~+/]+=*/gi, '$1[REDACTED]')
+        .replace(/((?:api[_-]?key|secret|token|password)\s*[:=]\s*['"]?)[^\s'"&]+/gi, '$1[REDACTED]');
+}
+export class McpClientError extends Error {
+    category;
+    constructor(message, category) {
+        super(message);
+        this.name = 'McpClientError';
+        this.category = category;
+    }
+}
+export async function createMcpSession(serverCommand, env, timeoutMs = 15000) {
+    const { command, args } = parseCommand(serverCommand);
+    const transport = new StdioClientTransport({
+        command,
+        args,
+        env: {
+            ...process.env,
+            ...(env || {}),
+        },
+        stderr: 'pipe',
+    });
+    const client = new Client({
+        name: 'mcpdrift',
+        version: '1.0.0',
+    }, {
+        capabilities: {},
+    });
+    let stderrOutput = '';
+    if (transport.stderr) {
+        transport.stderr.on('data', (chunk) => {
+            stderrOutput += chunk.toString();
+        });
+    }
+    let spawnError = null;
+    // Listen for process errors if transport exposed process
+    const proc = transport._process;
+    if (proc) {
+        proc.once('error', (err) => {
+            spawnError = err;
+        });
+    }
+    const connectPromise = client.connect(transport);
+    const timeoutPromise = new Promise((_, reject) => {
+        const timer = setTimeout(() => {
+            const sanitized = sanitizeStderr(stderrOutput.trim());
+            reject(new McpClientError(`Timed out connecting to MCP server after ${timeoutMs}ms.\nCommand: ${serverCommand}${sanitized ? `\nServer stderr: ${sanitized}` : ''}`, 'CONNECTION_FAILURE'));
+        }, timeoutMs);
+        timer.unref?.();
+    });
+    try {
+        await Promise.race([connectPromise, timeoutPromise]);
+    }
+    catch (err) {
+        try {
+            await transport.close();
+        }
+        catch {
+            // Ignore close errors during failure cleanup
+        }
+        const sanitized = sanitizeStderr(stderrOutput.trim());
+        const isSpawn = spawnError || err.code === 'ENOENT' || /spawn.*ENOENT/i.test(err.message);
+        const category = isSpawn ? 'STARTUP_FAILURE' : 'CONNECTION_FAILURE';
+        throw new McpClientError(`Failed to start or connect to MCP server (${serverCommand}): ${err.message}${sanitized ? `\nServer stderr:\n${sanitized}` : ''}`, category);
+    }
+    const close = async () => {
+        try {
+            await transport.close();
+        }
+        catch {
+            // Best effort
+        }
+        try {
+            await client.close();
+        }
+        catch {
+            // Best effort
+        }
+        // Force kill if process remains alive
+        const child = transport._process;
+        if (child && !child.killed) {
+            try {
+                child.kill();
+            }
+            catch {
+                // Ignore
+            }
+        }
+    };
+    return { client, transport, close };
+}
+export async function executeToolWithTimeout(client, toolName, args = {}, timeoutMs = 15000) {
+    const callPromise = client.callTool({
+        name: toolName,
+        arguments: args,
+    });
+    const timeoutPromise = new Promise((_, reject) => {
+        const timer = setTimeout(() => {
+            reject(new McpClientError(`Tool "${toolName}" timed out after ${timeoutMs}ms.`, 'TOOL_TIMEOUT'));
+        }, timeoutMs);
+        timer.unref?.();
+    });
+    return (await Promise.race([callPromise, timeoutPromise]));
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAGjF,MAAM,UAAU,YAAY,CAAC,UAAkB;IAC7C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,QAAQ,GAAG,CAAC,QAAQ,CAAC;QACvB,CAAC;aAAM,IAAI,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACrC,QAAQ,GAAG,CAAC,QAAQ,CAAC;QACvB,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;YACrD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACrB,OAAO,GAAG,EAAE,CAAC;YACf,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,IAAI,CAAC;QAClB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;KACtB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAC1B,OAAO,SAAS;SACb,OAAO,CAAC,sCAAsC,EAAE,cAAc,CAAC;SAC/D,OAAO,CAAC,mEAAmE,EAAE,cAAc,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAkB;IAE1B,YAAY,OAAe,EAAE,QAAyB;QACpD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAQD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,aAAqB,EACrB,GAA4B,EAC5B,YAAoB,KAAK;IAEzB,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;IAEtD,MAAM,SAAS,GAAG,IAAI,oBAAoB,CAAC;QACzC,OAAO;QACP,IAAI;QACJ,GAAG,EAAE;YACH,GAAG,OAAO,CAAC,GAAG;YACd,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC;SACW;QAC3B,MAAM,EAAE,MAAM;KACf,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE,EAAE;KACjB,CACF,CAAC;IAEF,IAAI,YAAY,GAAG,EAAE,CAAC;IACtB,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;QACrB,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YAC5C,YAAY,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,UAAU,GAAiB,IAAI,CAAC;IACpC,yDAAyD;IACzD,MAAM,IAAI,GAAI,SAAiB,CAAC,QAAQ,CAAC;IACzC,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;YAChC,UAAU,GAAG,GAAG,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACjD,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QACtD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,SAAS,GAAG,cAAc,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;YACtD,MAAM,CACJ,IAAI,cAAc,CAChB,4CAA4C,SAAS,iBAAiB,aAAa,GACjF,SAAS,CAAC,CAAC,CAAC,oBAAoB,SAAS,EAAE,CAAC,CAAC,CAAC,EAChD,EAAE,EACF,oBAAoB,CACrB,CACF,CAAC;QACJ,CAAC,EAAE,SAAS,CAAC,CAAC;QACd,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,6CAA6C;QAC/C,CAAC;QAED,MAAM,SAAS,GAAG,cAAc,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,UAAU,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1F,MAAM,QAAQ,GAAoB,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,oBAAoB,CAAC;QAErF,MAAM,IAAI,cAAc,CACtB,6CAA6C,aAAa,MAAM,GAAG,CAAC,OAAO,GACzE,SAAS,CAAC,CAAC,CAAC,qBAAqB,SAAS,EAAE,CAAC,CAAC,CAAC,EACjD,EAAE,EACF,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,IAAI,EAAE;QACvB,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;QAED,sCAAsC;QACtC,MAAM,KAAK,GAAI,SAAiB,CAAC,QAAQ,CAAC;QAC1C,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAc,EACd,QAAgB,EAChB,OAAgC,EAAE,EAClC,YAAoB,KAAK;IAEzB,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC;QAClC,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QACtD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CAAC,IAAI,cAAc,CAAC,SAAS,QAAQ,qBAAqB,SAAS,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC;QACnG,CAAC,EAAE,SAAS,CAAC,CAAC;QACd,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAY,CAAC;AACxE,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,12 @@
+import type { McpdriftConfig } from './types.js';
+export declare const DEFAULT_CONFIG_FILE = "mcpdrift.config.json";
+export declare const DEFAULT_SNAPSHOT_DIR: string;
+export declare function resolveConfigPath(customPath?: string): string;
+export declare function loadConfig(configPath?: string): {
+    config: McpdriftConfig;
+    resolvedPath: string;
+};
+export declare function validateConfig(data: any, filePath: string): McpdriftConfig;
+export declare function sanitizeToolFileName(toolName: string): string;
+export declare function getSnapshotPath(snapshotDir: string, caseId: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAoB,MAAM,YAAY,CAAC;AAInE,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAC1D,eAAO,MAAM,oBAAoB,QAAsC,CAAC;AAExE,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAyBhG;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CA+F1E;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3E"}

package/dist/config.js

@@ -0,0 +1,123 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { validatePointer } from './jsonPointer.js';
+import { validateCaseId, resolveSafeSnapshotPath } from './fsUtil.js';
+export const DEFAULT_CONFIG_FILE = 'mcpdrift.config.json';
+export const DEFAULT_SNAPSHOT_DIR = path.join('.mcpdrift', 'snapshots');
+export function resolveConfigPath(customPath) {
+    if (customPath) {
+        return path.resolve(process.cwd(), customPath);
+    }
+    return path.resolve(process.cwd(), DEFAULT_CONFIG_FILE);
+}
+export function loadConfig(configPath) {
+    const targetPath = resolveConfigPath(configPath);
+    if (!fs.existsSync(targetPath)) {
+        throw new Error(`Configuration file not found at: ${targetPath}\nRun 'mcpdrift init' to generate a starter configuration.`);
+    }
+    let raw;
+    try {
+        raw = fs.readFileSync(targetPath, 'utf-8');
+    }
+    catch (err) {
+        throw new Error(`Failed to read configuration file at ${targetPath}: ${err.message}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Failed to parse JSON configuration file at ${targetPath}: ${err.message}`);
+    }
+    const config = validateConfig(parsed, targetPath);
+    return { config, resolvedPath: targetPath };
+}
+export function validateConfig(data, filePath) {
+    if (!data || typeof data !== 'object') {
+        throw new Error(`Invalid configuration in ${filePath}: Config must be a JSON object.`);
+    }
+    if (typeof data.serverCommand !== 'string' || data.serverCommand.trim() === '') {
+        throw new Error(`Invalid configuration in ${filePath}: "serverCommand" string is required.`);
+    }
+    if (!Array.isArray(data.testCases) || data.testCases.length === 0) {
+        throw new Error(`Invalid configuration in ${filePath}: "testCases" must be a non-empty array.`);
+    }
+    // Count occurrences of each tool to determine if default tool-based IDs are safe
+    const toolCounts = {};
+    for (let i = 0; i < data.testCases.length; i++) {
+        const tc = data.testCases[i];
+        if (tc && typeof tc === 'object' && typeof tc.tool === 'string') {
+            const toolName = tc.tool.trim();
+            toolCounts[toolName] = (toolCounts[toolName] || 0) + 1;
+        }
+    }
+    const validatedCases = [];
+    const seenIds = new Set();
+    for (let i = 0; i < data.testCases.length; i++) {
+        const tc = data.testCases[i];
+        if (!tc || typeof tc !== 'object') {
+            throw new Error(`Invalid testCase at index ${i}: Must be an object.`);
+        }
+        if (typeof tc.tool !== 'string' || tc.tool.trim() === '') {
+            throw new Error(`Invalid testCase at index ${i}: "tool" name string is required.`);
+        }
+        if (tc.input !== undefined && (typeof tc.input !== 'object' || tc.input === null)) {
+            throw new Error(`Invalid testCase for tool "${tc.tool}": "input" must be an object.`);
+        }
+        const tool = tc.tool.trim();
+        let id;
+        if (tc.id !== undefined) {
+            if (typeof tc.id !== 'string' || tc.id.trim() === '') {
+                throw new Error(`Invalid testCase at index ${i}: "id" must be a non-empty string.`);
+            }
+            id = tc.id.trim();
+            validateCaseId(id);
+        }
+        else {
+            // Backward compatibility: If only one case exists for this tool, default id to tool name
+            if (toolCounts[tool] > 1) {
+                throw new Error(`Ambiguous test case at index ${i} for tool "${tool}": Multiple test cases exist for tool "${tool}". ` +
+                    `Each must specify a unique "id" to prevent snapshot collisions.`);
+            }
+            id = tool;
+            validateCaseId(id);
+        }
+        if (seenIds.has(id)) {
+            throw new Error(`Duplicate test case ID "${id}" at index ${i}. Every test case must have a globally unique "id".`);
+        }
+        seenIds.add(id);
+        // Validate ignore rules if present
+        let ignoreRules;
+        if (tc.ignore !== undefined) {
+            if (!Array.isArray(tc.ignore)) {
+                throw new Error(`Invalid testCase "${id}": "ignore" must be an array of JSON Pointer strings.`);
+            }
+            for (const rule of tc.ignore) {
+                validatePointer(rule);
+            }
+            ignoreRules = tc.ignore;
+        }
+        validatedCases.push({
+            id,
+            tool,
+            input: tc.input || {},
+            name: tc.name,
+            timeout: typeof tc.timeout === 'number' ? tc.timeout : undefined,
+            ignore: ignoreRules,
+        });
+    }
+    return {
+        serverCommand: data.serverCommand.trim(),
+        testCases: validatedCases,
+        snapshotDir: data.snapshotDir || DEFAULT_SNAPSHOT_DIR,
+        timeout: typeof data.timeout === 'number' ? data.timeout : 15000,
+        env: data.env || {},
+    };
+}
+export function sanitizeToolFileName(toolName) {
+    return toolName.replace(/[<>:"/\\|?*]/g, '_');
+}
+export function getSnapshotPath(snapshotDir, caseId) {
+    return resolveSafeSnapshotPath(snapshotDir, caseId);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/differ.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Sorts object keys recursively to produce deterministic JSON comparisons
+ */
+export declare function sortKeys(obj: any): any;
+export declare function areResponsesEqual(baseline: unknown, actual: unknown): boolean;
+export declare function formatJson(data: unknown): string;
+/**
+ * Generates a clean, colored line-by-line diff comparing baseline to actual response
+ */
+export declare function generateDiff(baseline: unknown, actual: unknown, caseId: string, ignoredPointers?: string[]): string;
+//# sourceMappingURL=differ.d.ts.map

package/dist/differ.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"differ.d.ts","sourceRoot":"","sources":["../src/differ.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAatC;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAI7E;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,MAAM,CAwCR"}

package/dist/differ.js

@@ -0,0 +1,57 @@
+import * as Diff from 'diff';
+import chalk from 'chalk';
+/**
+ * Sorts object keys recursively to produce deterministic JSON comparisons
+ */
+export function sortKeys(obj) {
+    if (obj === null || typeof obj !== 'object') {
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map(sortKeys);
+    }
+    const sortedKeys = Object.keys(obj).sort();
+    const result = {};
+    for (const key of sortedKeys) {
+        result[key] = sortKeys(obj[key]);
+    }
+    return result;
+}
+export function areResponsesEqual(baseline, actual) {
+    const sortedBaseline = JSON.stringify(sortKeys(baseline));
+    const sortedActual = JSON.stringify(sortKeys(actual));
+    return sortedBaseline === sortedActual;
+}
+export function formatJson(data) {
+    return JSON.stringify(sortKeys(data), null, 2);
+}
+/**
+ * Generates a clean, colored line-by-line diff comparing baseline to actual response
+ */
+export function generateDiff(baseline, actual, caseId, ignoredPointers) {
+    const baselineStr = formatJson(baseline);
+    const actualStr = formatJson(actual);
+    const patch = Diff.structuredPatch(`baseline/${caseId}.json`, `actual/${caseId}.json`, baselineStr, actualStr, 'baseline', 'actual');
+    const lines = [];
+    lines.push(chalk.dim(`--- baseline (.mcpdrift/snapshots/${caseId}.json)`));
+    lines.push(chalk.dim(`+++ actual (received from MCP server)`));
+    if (ignoredPointers && ignoredPointers.length > 0) {
+        lines.push(chalk.dim(`ℹ️  Ignore rules active (${ignoredPointers.length} rule(s) omitted before diff)`));
+    }
+    for (const hunk of patch.hunks) {
+        lines.push(chalk.cyan(`@@ -${hunk.oldStart},${hunk.oldLines} +${hunk.newStart},${hunk.newLines} @@`));
+        for (const line of hunk.lines) {
+            if (line.startsWith('+')) {
+                lines.push(chalk.green(line));
+            }
+            else if (line.startsWith('-')) {
+                lines.push(chalk.red(line));
+            }
+            else {
+                lines.push(chalk.dim(line));
+            }
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=differ.js.map

package/dist/differ.js.map

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

package/dist/fsUtil.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Validates that a test case identifier is safe for filesystem snapshot usage.
+ * Prevents path traversal, directory navigation, and invalid characters.
+ */
+export declare function validateCaseId(id: string): void;
+/**
+ * Resolves a snapshot path safely, ensuring the target file strictly stays inside snapshotDir.
+ */
+export declare function resolveSafeSnapshotPath(snapshotDir: string, caseId: string): string;
+/**
+ * Atomically writes content to a file by writing to a temporary file in the same directory first
+ * and then renaming it. Avoids partial/corrupt files if interrupted.
+ */
+export declare function writeAtomic(targetFilePath: string, content: string): void;
+//# sourceMappingURL=fsUtil.d.ts.map

package/dist/fsUtil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsUtil.d.ts","sourceRoot":"","sources":["../src/fsUtil.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CA6B/C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAanF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CA2BzE"}

package/dist/fsUtil.js

@@ -0,0 +1,70 @@
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Validates that a test case identifier is safe for filesystem snapshot usage.
+ * Prevents path traversal, directory navigation, and invalid characters.
+ */
+export function validateCaseId(id) {
+    if (typeof id !== 'string' || id.trim() === '') {
+        throw new Error('Test case ID must be a non-empty string.');
+    }
+    const trimmed = id.trim();
+    if (trimmed === '.' || trimmed === '..') {
+        throw new Error(`Invalid test case ID "${id}": ID cannot be "." or ".."`);
+    }
+    // Check for forbidden path traversal characters: /, \, null byte, control characters
+    if (/[\/\\\x00-\x1F\x7F]/.test(trimmed)) {
+        throw new Error(`Invalid test case ID "${id}": Path traversal characters (/ and \\) and control characters are not allowed.`);
+    }
+    // Disallow forbidden filename characters across Windows and POSIX: < > : " | ? *
+    if (/[<>:"|?*]/.test(trimmed)) {
+        throw new Error(`Invalid test case ID "${id}": Forbidden filename characters (< > : " | ? *) are not allowed.`);
+    }
+    // Max length check to prevent filesystem boundary overflows
+    if (trimmed.length > 120) {
+        throw new Error(`Invalid test case ID "${id}": ID exceeds maximum length of 120 characters.`);
+    }
+}
+/**
+ * Resolves a snapshot path safely, ensuring the target file strictly stays inside snapshotDir.
+ */
+export function resolveSafeSnapshotPath(snapshotDir, caseId) {
+    validateCaseId(caseId);
+    const absoluteSnapshotDir = path.resolve(snapshotDir);
+    const targetFile = path.resolve(absoluteSnapshotDir, `${caseId}.json`);
+    // Path traversal check
+    const relative = path.relative(absoluteSnapshotDir, targetFile);
+    if (relative.startsWith('..') || path.isAbsolute(relative)) {
+        throw new Error(`Security violation: Snapshot path for "${caseId}" resolves outside snapshot directory.`);
+    }
+    return targetFile;
+}
+/**
+ * Atomically writes content to a file by writing to a temporary file in the same directory first
+ * and then renaming it. Avoids partial/corrupt files if interrupted.
+ */
+export function writeAtomic(targetFilePath, content) {
+    const dir = path.dirname(targetFilePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const tempFile = path.join(dir, `.tmp.${path.basename(targetFilePath)}.${Date.now()}.${Math.random().toString(36).slice(2, 8)}`);
+    try {
+        fs.writeFileSync(tempFile, content, 'utf-8');
+        fs.renameSync(tempFile, targetFilePath);
+    }
+    catch (err) {
+        // If rename fails (e.g. edge-case Windows file lock), try to clean up temp file
+        try {
+            if (fs.existsSync(tempFile)) {
+                fs.unlinkSync(tempFile);
+            }
+        }
+        catch {
+            // Best-effort cleanup
+        }
+        // Direct write fallback
+        fs.writeFileSync(targetFilePath, content, 'utf-8');
+    }
+}
+//# sourceMappingURL=fsUtil.js.map

package/dist/fsUtil.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from './types.js';
+export * from './config.js';
+export * from './differ.js';
+export * from './client.js';
+export * from './runner.js';
+export * from './approver.js';
+export * from './initializer.js';
+export * from './jsonPointer.js';
+export * from './fsUtil.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export * from './types.js';
+export * from './config.js';
+export * from './differ.js';
+export * from './client.js';
+export * from './runner.js';
+export * from './approver.js';
+export * from './initializer.js';
+export * from './jsonPointer.js';
+export * from './fsUtil.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}

package/dist/initializer.d.ts

@@ -0,0 +1,10 @@
+export interface InitOptions {
+    server?: string;
+    output?: string;
+    force?: boolean;
+    tools?: string[];
+    allTools?: boolean;
+    template?: boolean;
+}
+export declare function initConfig(options?: InitOptions): Promise<void>;
+//# sourceMappingURL=initializer.d.ts.map

package/dist/initializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initializer.d.ts","sourceRoot":"","sources":["../src/initializer.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAgED,wBAAsB,UAAU,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuHzE"}