mcprigor 1.0.0-rc.1

package/dist/cli.js

@@ -0,0 +1,265 @@
+#!/usr/bin/env node
+import { readFile, writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import YAML from "yaml";
+import { authorTest, createReadlinePromptAdapter } from "./author.js";
+import { checkContract, compareContracts, contractMarkdown, contractReport, readContract, updateContract } from "./contract.js";
+import { discoverTarget, generateSuite, writeGeneratedSuite, writeLock } from "./discovery.js";
+import { loadTestFile } from "./qa-loader.js";
+import { parityMarkdown, parityReport, runParity } from "./parity.js";
+import { terminalReport, writeHtmlReport, writeJsonReport, writeJunitReport } from "./reporters.js";
+import { runSuite } from "./runner.js";
+import { replayReport, replayTrace } from "./replay.js";
+import { readState, writeState } from "./state.js";
+import { compareEvidence, showEvidence, TraceRecorder, writeEvidenceBundle } from "./trace.js";
+import { collectTargetSecrets, createRedactor } from "./redact.js";
+import { writeStarter } from "./starter.js";
+import { startWorkspace } from "./workspace.js";
+import { installSignalCleanup } from "./session.js";
+import { formatFailure } from "./errors.js";
+const removeSignalCleanup = installSignalCleanup();
+async function main() {
+    const [command, file, ...flags] = process.argv.slice(2);
+    if (!command || command === "--help" || command === "-h")
+        return help();
+    if (command === "workspace" || command === "web") {
+        const workspace = await startWorkspace({ root: file && !file.startsWith("--") ? file : process.cwd(), port: numericFlag([file ?? "", ...flags], "--port") });
+        console.log(`MCP Rigor QA Workspace\n${workspace.url}\n\nPress Ctrl+C to stop.`);
+        return new Promise(() => { });
+    }
+    const compileOptions = { allowRemoteData: flags.includes("--allow-remote-data"), allowCustomCode: flags.includes("--allow-custom-code"), maxRows: numericFlag(flags, "--max-rows") };
+    if (command === "snapshot-diff") {
+        if (!file || !flags[0])
+            throw new UsageError("snapshot-diff requires two JSON files");
+        const { semanticDiff, renderSemanticDiff } = await import("./snapshots.js");
+        const changes = semanticDiff(JSON.parse(await readFile(file, "utf8")), JSON.parse(await readFile(flags[0], "utf8")));
+        console.log(changes.length ? renderSemanticDiff(changes) : "Snapshots are semantically identical.");
+        process.exitCode = changes.length ? 1 : 0;
+        return;
+    }
+    if (command === "evidence-show") {
+        if (!file)
+            throw new UsageError("evidence-show requires a bundle directory");
+        console.log(await showEvidence(file));
+        return;
+    }
+    if (command === "evidence-compare") {
+        if (!file)
+            throw new UsageError("evidence-compare requires two bundle directories");
+        const second = flags[0];
+        if (!second)
+            throw new UsageError("evidence-compare requires two bundle directories");
+        console.log(await compareEvidence(file, second));
+        return;
+    }
+    if (command === "replay") {
+        if (!file)
+            throw new UsageError("replay requires a trace JSONL file");
+        const targetFile = requiredFlag(flags, "--target");
+        const suite = await loadTestFile(resolve(targetFile), compileOptions);
+        const result = await replayTrace(resolve(file), suite.target, { allowTools: repeatedFlag(flags, "--allow-tool"), timeoutMs: numericFlag(flags, "--timeout") });
+        console.log(replayReport(result));
+        process.exitCode = result.status === "passed" ? 0 : 1;
+        return;
+    }
+    if (command === "contract-diff") {
+        if (!file || !flags[0])
+            throw new UsageError("contract-diff requires OLD and NEW lock files");
+        const diff = compareContracts(await readContract(file), await readContract(flags[0]));
+        console.log(flags.includes("--markdown") ? contractMarkdown(diff) : contractReport(diff));
+        process.exitCode = diff.breaking ? 1 : 0;
+        return;
+    }
+    if (command === "init") {
+        const output = file ?? "my-mcp-tests.mcpr";
+        await writeStarter(output, flags.includes("--force"));
+        console.log(`✓ Created ${output}\n\nNext:\n  1. Open the file and set your server command or URL.\n  2. Change the example tool and expected result.\n  3. Run: mcprigor test ${output}`);
+        return;
+    }
+    if (!file)
+        throw new UsageError(`The ${command} command requires a test file`);
+    if (command === "author" || command === "create") {
+        const targetSuite = await loadTestFile(resolve(file), compileOptions);
+        const output = flag(flags, "--out") ?? "authored-test.mcpr";
+        const prompts = createReadlinePromptAdapter();
+        try {
+            await authorTest(targetSuite.target, prompts, output);
+            console.log(`\n✓ Created ${output}\nRun it with: mcprigor test ${output}`);
+        }
+        finally {
+            await prompts.close();
+        }
+        return;
+    }
+    if (command === "parity") {
+        const suite = await loadTestFile(resolve(file), compileOptions);
+        if (!suite.targets)
+            throw new UsageError("parity requires at least two named targets in the suite's targets section");
+        const result = await runParity(suite, suite.targets, { allowCustomCode: compileOptions.allowCustomCode, cwd: process.cwd() });
+        const report = flags.includes("--markdown") ? parityMarkdown(result) : parityReport(result);
+        const out = flag(flags, "--out");
+        if (out)
+            await writeFile(out, report, "utf8");
+        else
+            console.log(report);
+        process.exitCode = result.status === "passed" ? 0 : 1;
+        return;
+    }
+    if (command === "validate" || command === "check") {
+        await loadTestFile(resolve(file), compileOptions);
+        console.log(`✓ ${file} looks good and is ready to run`);
+        return;
+    }
+    if (command === "contract-check") {
+        const suite = await loadTestFile(resolve(requiredFlag(flags, "--target")), compileOptions);
+        const checked = await checkContract(resolve(file), suite.target);
+        const report = flags.includes("--markdown") ? contractMarkdown(checked.diff) : contractReport(checked.diff);
+        const out = flag(flags, "--out");
+        if (out)
+            await writeFile(out, report + "\n", "utf8");
+        else
+            console.log(report);
+        process.exitCode = checked.diff.breaking ? 1 : 0;
+        return;
+    }
+    if (command === "contract-update") {
+        const suite = await loadTestFile(resolve(requiredFlag(flags, "--target")), compileOptions);
+        const diff = await updateContract(resolve(file), suite.target);
+        console.log(contractReport(diff));
+        return;
+    }
+    if (command === "discover") {
+        const suite = await loadTestFile(resolve(file), compileOptions);
+        const output = flag(flags, "--out") ?? "mcp.lock.yaml";
+        const lock = await discoverTarget(suite.target);
+        await writeLock(lock, output);
+        console.log(`✓ Found ${lock.tools.length} tools, ${lock.resources.length} resources, and ${lock.prompts.length} prompts`);
+        console.log(`  Saved the server contract to ${output}`);
+        return;
+    }
+    if (command === "generate") {
+        const lock = YAML.parse(await readFile(resolve(file), "utf8"));
+        const targetFile = requiredFlag(flags, "--target");
+        const target = (await loadTestFile(resolve(targetFile))).target;
+        const output = flag(flags, "--out") ?? "mcp.generated.yaml";
+        await writeGeneratedSuite(generateSuite(lock, target), output);
+        console.log(`✓ Created ready-to-run contract tests in ${output}`);
+        return;
+    }
+    if (command !== "run" && command !== "test")
+        throw new UsageError(`Unknown command: ${command}. Try: mcprigor --help`);
+    const suite = await loadTestFile(resolve(file), compileOptions);
+    const filter = flag(flags, "--test");
+    const stateIn = flag(flags, "--state-in");
+    const loadedState = stateIn ? await readState(resolve(stateIn), suite.target, flags.includes("--allow-state-target-mismatch")) : undefined;
+    const evidenceDirectory = flag(flags, "--evidence");
+    const trace = evidenceDirectory ? new TraceRecorder(createRedactor([...(suite.redact ?? []), ...collectTargetSecrets(suite.target)])) : undefined;
+    const snapshotFile = flag(flags, "--snapshot");
+    if (flags.includes("--update-snapshots") && !snapshotFile && !suite.snapshots?.file)
+        throw new UsageError("--update-snapshots requires --snapshot FILE or suite snapshot configuration");
+    const result = await runSuite(suite, { ...(filter ? { filter } : {}), allowCustomCode: compileOptions.allowCustomCode, cwd: process.cwd(), state: loadedState?.outputs, trace, snapshotFile, updateSnapshots: flags.includes("--update-snapshots") });
+    console.log(terminalReport(result));
+    const json = flag(flags, "--json");
+    const junit = flag(flags, "--junit");
+    const html = flag(flags, "--html");
+    if (json)
+        await writeJsonReport(result, json);
+    if (junit)
+        await writeJunitReport(result, junit);
+    if (html) {
+        await writeHtmlReport(result, html);
+        console.log(`\nReadable report: ${html}`);
+    }
+    if (evidenceDirectory && trace) {
+        const manifest = await writeEvidenceBundle(evidenceDirectory, result, suite.target, trace);
+        console.log(`\nEvidence bundle: ${evidenceDirectory}\nNormalized trace: ${manifest.normalizedTraceHash}`);
+    }
+    const stateOut = flag(flags, "--state-out");
+    if (stateOut && result.status === "passed") {
+        await writeState(resolve(stateOut), suite.target, suite, result.outputs);
+        console.log(`\nSaved reusable outputs: ${stateOut}`);
+    }
+    else if (stateOut)
+        console.log("\nState was not saved because the run did not pass.");
+    process.exitCode = result.status === "passed" ? 0 : 1;
+}
+function flag(args, name) {
+    const index = args.indexOf(name);
+    return index >= 0 ? args[index + 1] : undefined;
+}
+function repeatedFlag(args, name) { return args.flatMap((value, index) => value === name && args[index + 1] ? [args[index + 1]] : []); }
+function numericFlag(args, name) {
+    const value = flag(args, name);
+    if (value === undefined)
+        return undefined;
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < 1)
+        throw new UsageError(`${name} must be a positive whole number`);
+    return parsed;
+}
+function requiredFlag(args, name) {
+    const value = flag(args, name);
+    if (!value)
+        throw new UsageError(`${name} is required`);
+    return value;
+}
+function help() {
+    console.log(`MCP Rigor — acceptance testing for everyone
+
+Start here:
+  mcprigor workspace [DIRECTORY] [--port 4173]
+                                      Open the local QA web workspace
+  mcprigor init my-tests.mcpr       Create an editable example
+  mcprigor check my-tests.mcpr      Check the wording before running
+  mcprigor test my-tests.mcpr       Run the tests
+  mcprigor test my-tests.mcpr --html report.html
+  mcprigor author server.mcpr --out new-test.mcpr
+                                      Guided no-code test creation
+
+Transport parity:
+  mcprigor parity suite.mcpr [--markdown] [--out parity.md]
+  In .mcpr: Compare target "Local": node server.js
+           Compare target "QA": https://qa.example.com/mcp
+
+Data engineering:
+  Typed columns, validation, filters, derived values, joins, deterministic samples
+  --max-rows 1000          Limit expanded data rows
+  --allow-remote-data      Allow REST and Google Sheets
+  --allow-custom-code      Allow reviewed function/provider modules
+
+Cross-test and cross-run state:
+  --state-in state.json    Load read-only values as \${state.name}
+  --state-out state.json   Save successful exported outputs
+  --allow-state-target-mismatch  Accept reviewed state from another target
+
+Contract drift:
+  mcprigor contract-check mcp.lock.yaml --target server.mcpr [--markdown]
+  mcprigor contract-diff old.lock.yaml new.lock.yaml [--markdown]
+  mcprigor contract-update mcp.lock.yaml --target server.mcpr
+
+Snapshots and replay:
+  mcprigor test tests.mcpr --snapshot expected.snap.json
+  mcprigor test tests.mcpr --snapshot expected.snap.json --update-snapshots
+  mcprigor snapshot-diff OLD.json NEW.json
+  mcprigor replay trace.normalized.jsonl --target server.mcpr [--allow-tool NAME]
+
+Evidence:
+  mcprigor test tests.mcpr --evidence .mcprigor/run-1
+  mcprigor evidence-show .mcprigor/run-1
+  mcprigor evidence-compare RUN-A RUN-B
+
+Advanced:
+  mcprigor discover <test-file> [--out mcp.lock.yaml]
+  mcprigor generate <lock-file> --target <test-file>
+  mcprigor run <yaml-or-json> [--json result.json] [--junit result.xml]
+
+Test files can use friendly .mcpr language or YAML/JSON. No AI or coding is required.`);
+}
+class UsageError extends Error {
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`\nMCP Rigor could not continue\n${formatFailure(error)}\n\nTip: run 'mcprigor check <your-file>' to check the test wording.`);
+    process.exitCode = error instanceof UsageError || /MCP-CONFIG|QA-LANG|QA-INIT|required/.test(message) ? 2 : 3;
+}).finally(() => removeSignalCleanup());
+//# sourceMappingURL=cli.js.map

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/contract.d.ts

@@ -0,0 +1,28 @@
+import type { DiscoveryDocument, Target } from "./types.js";
+export type DriftSeverity = "breaking" | "potentially-breaking" | "non-breaking";
+export interface ContractChange {
+    severity: DriftSeverity;
+    code: string;
+    path: string;
+    message: string;
+    before?: unknown;
+    after?: unknown;
+}
+export interface ContractDiff {
+    status: "unchanged" | "changed";
+    breaking: number;
+    potentiallyBreaking: number;
+    nonBreaking: number;
+    changes: ContractChange[];
+}
+export declare function compareContracts(before: DiscoveryDocument, after: DiscoveryDocument): ContractDiff;
+export declare function checkContract(lockFile: string, target: Target): Promise<{
+    lock: DiscoveryDocument;
+    current: DiscoveryDocument;
+    diff: ContractDiff;
+}>;
+export declare function updateContract(lockFile: string, target: Target): Promise<ContractDiff>;
+export declare function readContract(file: string): Promise<DiscoveryDocument>;
+export declare function contractReport(diff: ContractDiff): string;
+export declare function contractMarkdown(diff: ContractDiff): string;
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAG5D,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,sBAAsB,GAAG,cAAc,CAAC;AACjF,MAAM,WAAW,cAAc;IAAG,QAAQ,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE;AAC3I,MAAM,WAAW,YAAY;IAAG,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,cAAc,EAAE,CAAA;CAAE;AAEhK,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAUlG;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC,CAG1J;AACD,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAE5F;AACD,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAE3E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CASzD;AACD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAG3D"}

package/dist/contract.js

@@ -0,0 +1,138 @@
+import { readFile } from "node:fs/promises";
+import YAML from "yaml";
+import { discoverTarget, writeLock } from "./discovery.js";
+export function compareContracts(before, after) {
+    const changes = [];
+    if (before.protocolVersion !== after.protocolVersion)
+        changes.push(change("potentially-breaking", "MCP-DRIFT-001", "protocolVersion", `Protocol version changed from ${before.protocolVersion ?? "unknown"} to ${after.protocolVersion ?? "unknown"}`, before.protocolVersion, after.protocolVersion));
+    diffCapabilities(before.server.capabilities, after.server.capabilities, changes);
+    diffNamed("tool", before.tools, after.tools, "name", changes);
+    diffNamed("resource", before.resources, after.resources, "uri", changes);
+    diffNamed("resource template", before.resourceTemplates, after.resourceTemplates, "uriTemplate", changes);
+    diffNamed("prompt", before.prompts, after.prompts, "name", changes);
+    changes.sort((a, b) => rank(a.severity) - rank(b.severity) || a.path.localeCompare(b.path) || a.code.localeCompare(b.code));
+    return { status: changes.length ? "changed" : "unchanged", breaking: changes.filter((x) => x.severity === "breaking").length, potentiallyBreaking: changes.filter((x) => x.severity === "potentially-breaking").length, nonBreaking: changes.filter((x) => x.severity === "non-breaking").length, changes };
+}
+export async function checkContract(lockFile, target) {
+    const lock = await readContract(lockFile);
+    const current = await discoverTarget(target);
+    return { lock, current, diff: compareContracts(lock, current) };
+}
+export async function updateContract(lockFile, target) {
+    const previous = await readContract(lockFile);
+    const current = await discoverTarget(target);
+    const diff = compareContracts(previous, current);
+    await writeLock(current, lockFile);
+    return diff;
+}
+export async function readContract(file) {
+    const source = await readFile(file, "utf8");
+    return (file.endsWith(".json") ? JSON.parse(source) : YAML.parse(source));
+}
+export function contractReport(diff) {
+    if (!diff.changes.length)
+        return "No MCP contract changes detected.";
+    const lines = [`${diff.breaking} breaking, ${diff.potentiallyBreaking} potentially breaking, ${diff.nonBreaking} non-breaking changes`];
+    for (const severity of ["breaking", "potentially-breaking", "non-breaking"]) {
+        const group = diff.changes.filter((item) => item.severity === severity);
+        if (!group.length)
+            continue;
+        lines.push("", severity === "breaking" ? "Breaking" : severity === "potentially-breaking" ? "Potentially breaking" : "Non-breaking");
+        for (const item of group)
+            lines.push(`${severity === "breaking" ? "✗" : severity === "potentially-breaking" ? "!" : "✓"} ${item.message} [${item.code}]`);
+    }
+    return lines.join("\n");
+}
+export function contractMarkdown(diff) {
+    const icon = (severity) => severity === "breaking" ? "❌" : severity === "potentially-breaking" ? "⚠️" : "✅";
+    return [`# MCP Contract Drift`, "", `**${diff.breaking} breaking · ${diff.potentiallyBreaking} potentially breaking · ${diff.nonBreaking} non-breaking**`, "", ...diff.changes.map((item) => `- ${icon(item.severity)} **${item.code}** — ${item.message} \`${item.path}\``), ""].join("\n");
+}
+function diffCapabilities(before, after, changes) {
+    const oldKeys = keys(before);
+    const newKeys = keys(after);
+    for (const key of oldKeys)
+        if (!newKeys.has(key))
+            changes.push(change("breaking", "MCP-DRIFT-010", `capabilities.${key}`, `Capability “${key}” was removed`));
+    for (const key of newKeys)
+        if (!oldKeys.has(key))
+            changes.push(change("non-breaking", "MCP-DRIFT-011", `capabilities.${key}`, `Capability “${key}” was added`));
+}
+function diffNamed(kind, before, after, key, changes) {
+    const oldMap = index(before, key);
+    const newMap = index(after, key);
+    for (const [name] of oldMap)
+        if (!newMap.has(name))
+            changes.push(change("breaking", "MCP-DRIFT-100", `${kind}.${name}`, `${capitalize(kind)} “${name}” was removed`));
+    for (const [name] of newMap)
+        if (!oldMap.has(name))
+            changes.push(change("non-breaking", "MCP-DRIFT-101", `${kind}.${name}`, `${capitalize(kind)} “${name}” was added`));
+    for (const [name, oldItem] of oldMap) {
+        const next = newMap.get(name);
+        if (!next)
+            continue;
+        if (kind === "tool")
+            diffSchema(oldItem.inputSchema, next.inputSchema, `tools.${name}.inputSchema`, changes);
+        if (kind === "tool")
+            diffSchema(oldItem.outputSchema, next.outputSchema, `tools.${name}.outputSchema`, changes, true);
+        if (kind === "prompt")
+            diffPromptArgs(name, oldItem, next, changes);
+        if (JSON.stringify(oldItem.description) !== JSON.stringify(next.description))
+            changes.push(change("potentially-breaking", "MCP-DRIFT-120", `${kind}.${name}.description`, `${capitalize(kind)} “${name}” description changed`));
+    }
+}
+function diffSchema(before, after, path, changes, output = false) {
+    if (!before && after) {
+        changes.push(change(output ? "potentially-breaking" : "non-breaking", "MCP-DRIFT-200", path, `${output ? "Output" : "Input"} schema was added`));
+        return;
+    }
+    if (before && !after) {
+        changes.push(change("potentially-breaking", "MCP-DRIFT-201", path, `${output ? "Output" : "Input"} schema was removed`));
+        return;
+    }
+    if (!before || !after)
+        return;
+    if (before.type !== after.type)
+        changes.push(change("breaking", "MCP-DRIFT-202", `${path}.type`, `Schema type changed from ${String(before.type)} to ${String(after.type)}`));
+    const oldRequired = new Set(before.required ?? []);
+    const newRequired = new Set(after.required ?? []);
+    for (const name of newRequired)
+        if (!oldRequired.has(name))
+            changes.push(change("breaking", "MCP-DRIFT-203", `${path}.required.${name}`, `Required input “${name}” was added`));
+    for (const name of oldRequired)
+        if (!newRequired.has(name))
+            changes.push(change("non-breaking", "MCP-DRIFT-204", `${path}.required.${name}`, `Input “${name}” is no longer required`));
+    const oldProps = before.properties ?? {};
+    const newProps = after.properties ?? {};
+    for (const name of Object.keys(oldProps))
+        if (!(name in newProps))
+            changes.push(change("breaking", "MCP-DRIFT-205", `${path}.properties.${name}`, `Schema property “${name}” was removed`));
+    for (const name of Object.keys(newProps))
+        if (!(name in oldProps))
+            changes.push(change(newRequired.has(name) ? "breaking" : "non-breaking", "MCP-DRIFT-206", `${path}.properties.${name}`, `${newRequired.has(name) ? "Required" : "Optional"} schema property “${name}” was added`));
+    for (const name of Object.keys(oldProps))
+        if (name in newProps) {
+            if (oldProps[name]?.type !== newProps[name]?.type)
+                changes.push(change("breaking", "MCP-DRIFT-207", `${path}.properties.${name}.type`, `Property “${name}” type changed from ${String(oldProps[name]?.type)} to ${String(newProps[name]?.type)}`));
+            const oldEnum = oldProps[name]?.enum;
+            const newEnum = newProps[name]?.enum;
+            if (oldEnum && newEnum) {
+                for (const value of oldEnum)
+                    if (!newEnum.some((x) => JSON.stringify(x) === JSON.stringify(value)))
+                        changes.push(change("breaking", "MCP-DRIFT-208", `${path}.properties.${name}.enum`, `Enum value ${JSON.stringify(value)} was removed from “${name}”`));
+                for (const value of newEnum)
+                    if (!oldEnum.some((x) => JSON.stringify(x) === JSON.stringify(value)))
+                        changes.push(change("non-breaking", "MCP-DRIFT-209", `${path}.properties.${name}.enum`, `Enum value ${JSON.stringify(value)} was added to “${name}”`));
+            }
+        }
+}
+function diffPromptArgs(name, before, after, changes) { const oldMap = index(before.arguments ?? [], "name"); const newMap = index(after.arguments ?? [], "name"); for (const [arg, value] of oldMap)
+    if (!newMap.has(arg))
+        changes.push(change(value.required ? "breaking" : "potentially-breaking", "MCP-DRIFT-300", `prompts.${name}.arguments.${arg}`, `Prompt argument “${arg}” was removed from “${name}”`)); for (const [arg, value] of newMap)
+    if (!oldMap.has(arg))
+        changes.push(change(value.required ? "breaking" : "non-breaking", "MCP-DRIFT-301", `prompts.${name}.arguments.${arg}`, `${value.required ? "Required" : "Optional"} prompt argument “${arg}” was added to “${name}”`)); }
+function index(items, key) { return new Map(items.filter((item) => typeof item === "object" && item !== null && typeof item[key] === "string").map((item) => [String(item[key]), item])); }
+function keys(value) { return new Set(typeof value === "object" && value ? Object.keys(value) : []); }
+function change(severity, code, path, message, before, after) { return { severity, code, path, message, before, after }; }
+function rank(value) { return value === "breaking" ? 0 : value === "potentially-breaking" ? 1 : 2; }
+function capitalize(value) { return value.charAt(0).toUpperCase() + value.slice(1); }
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

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

package/dist/data.d.ts

@@ -0,0 +1,24 @@
+export interface DataRow {
+    id: string;
+    values: Record<string, unknown>;
+    index: number;
+    source: string;
+}
+export interface DataSet {
+    rows: DataRow[];
+    fingerprint: string;
+    source: string;
+}
+export interface DataContext {
+    cwd: string;
+    maxRows: number;
+    allowRemote: boolean;
+    allowCustomCode: boolean;
+    headers?: Record<string, string>;
+}
+export interface DataProvider {
+    load(config: Record<string, unknown>, context: DataContext): Promise<Record<string, unknown>[]>;
+}
+export declare function clearDataCache(): void;
+export declare function loadData(config: Record<string, unknown>, context?: Partial<DataContext>): Promise<DataSet>;
+//# sourceMappingURL=data.d.ts.map

package/dist/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../src/data.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,OAAO;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACvG,MAAM,WAAW,OAAO;IAAG,IAAI,EAAE,OAAO,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACjF,MAAM,WAAW,WAAW;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAC;IAAC,eAAe,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE;AAC/I,MAAM,WAAW,YAAY;IAAG,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;CAAE;AAGjI,wBAAgB,cAAc,IAAI,IAAI,CAA2B;AAEjE,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYpH"}