mcprigor 1.0.0-rc.1

package/dist/session.js

@@ -0,0 +1,111 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { CreateMessageRequestSchema, ElicitRequestSchema, ListRootsRequestSchema, LoggingMessageNotificationSchema, ProgressNotificationSchema, PromptListChangedNotificationSchema, ResourceListChangedNotificationSchema, ResourceUpdatedNotificationSchema, ResultSchema, TaskStatusNotificationSchema, ToolListChangedNotificationSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { RigorError } from "./errors.js";
+const activeSessions = new Set();
+export function createSession(target) { const session = new SdkSession(target, () => activeSessions.delete(session)); activeSessions.add(session); return session; }
+export async function shutdownSessions() { await Promise.allSettled([...activeSessions].map((session) => session.close())); activeSessions.clear(); }
+export function installSignalCleanup() { const handler = () => { void shutdownSessions().finally(() => { process.exitCode = 130; }); }; process.once("SIGINT", handler); process.once("SIGTERM", handler); return () => { process.off("SIGINT", handler); process.off("SIGTERM", handler); }; }
+class SdkSession {
+    target;
+    disposed;
+    client = new Client({ name: "mcprigor", version: "1.0.0-rc.1" }, { capabilities: { roots: { listChanged: true }, sampling: {}, elicitation: { form: {}, url: {} } } });
+    messages = [];
+    diagnosticBytes = 0;
+    nativeEvents = [];
+    sequence = 0;
+    behavior = {};
+    transport;
+    waiters = [];
+    constructor(target, disposed) {
+        this.target = target;
+        this.disposed = disposed;
+        this.installHandlers();
+    }
+    configureClient(behavior) { this.behavior = behavior; }
+    async connect() {
+        if (this.target.transport === "stdio") {
+            const env = this.target.env ? { ...process.env, ...this.target.env } : undefined;
+            this.transport = new StdioClientTransport({ command: this.target.command, args: this.target.args, cwd: this.target.cwd, env, stderr: "pipe" });
+            this.transport.stderr?.on("data", (chunk) => { if (this.diagnosticBytes >= 64 * 1024)
+                return; const text = String(chunk).slice(0, 16 * 1024).trimEnd(); this.diagnosticBytes += Buffer.byteLength(text); this.messages.push(text); });
+        }
+        else
+            this.transport = new StreamableHTTPClientTransport(new URL(this.target.url), { requestInit: { headers: this.target.headers } });
+        try {
+            await this.client.connect(this.transport, { timeout: 10_000 });
+        }
+        catch (error) {
+            await this.client.close().catch(() => { });
+            this.disposed();
+            const message = error instanceof Error ? error.message : String(error);
+            if (/ENOENT|spawn/i.test(message))
+                throw new RigorError("server-spawn", "MCP-SPAWN-001", message, undefined, error);
+            throw new RigorError(/timeout/i.test(message) ? "timeout" : "initialization", /timeout/i.test(message) ? "MCP-TIMEOUT-001" : "MCP-INIT-001", message, undefined, error);
+        }
+        const server = this.client.getServerVersion();
+        return { protocolVersion: this.transport instanceof StreamableHTTPClientTransport ? this.transport.protocolVersion : undefined, serverName: server?.name, serverVersion: server?.version, capabilities: this.client.getServerCapabilities() };
+    }
+    async request(method, params, timeoutMs = 10_000) { return this.client.request({ method, params: params }, ResultSchema, { timeout: timeoutMs }); }
+    async nativeRequest(method, params, options = {}) {
+        const progress = [];
+        const taskEvents = [];
+        const controller = new AbortController();
+        const timer = options.cancelAfterMs ? setTimeout(() => controller.abort(new Error("MCP request cancelled by test")), options.cancelAfterMs) : undefined;
+        try {
+            if (options.task && method === "tools/call") {
+                for await (const event of this.client.experimental.tasks.callToolStream(params, undefined, { timeout: options.timeoutMs, signal: controller.signal })) {
+                    taskEvents.push(event);
+                    if (event.type === "result")
+                        return { result: event.result, progress, taskEvents };
+                    if (event.type === "error")
+                        throw event.error;
+                }
+                throw new Error("MCP-TASK-001 Task stream ended without a result");
+            }
+            const result = await this.client.request({ method, params: params }, ResultSchema, { timeout: options.timeoutMs, signal: controller.signal, onprogress: options.progress ? (event) => progress.push(event) : undefined });
+            return { result, progress, taskEvents };
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+        }
+    }
+    events() { return structuredClone(this.nativeEvents); }
+    awaitEvent(method, timeoutMs = 5_000) {
+        const existing = this.nativeEvents.find((event) => event.method === method);
+        if (existing)
+            return Promise.resolve(structuredClone(existing));
+        return new Promise((resolve, reject) => { const timer = setTimeout(() => { this.waiters = this.waiters.filter((item) => item.timer !== timer); reject(new Error(`MCP-EVENT-001 Timed out waiting for ${method}`)); }, timeoutMs); this.waiters.push({ method, resolve, reject, timer }); });
+    }
+    async subscribe(uri) { return this.client.subscribeResource({ uri }); }
+    async unsubscribe(uri) { return this.client.unsubscribeResource({ uri }); }
+    async setLoggingLevel(level) { return this.client.setLoggingLevel(level); }
+    async close() { for (const waiter of this.waiters) {
+        clearTimeout(waiter.timer);
+        waiter.reject(new RigorError("cancellation", "MCP-CANCEL-001", "Session closed while waiting for an event"));
+    } this.waiters = []; try {
+        await this.client.close();
+    }
+    catch (error) {
+        throw new RigorError("cleanup", "MCP-CLEANUP-002", error instanceof Error ? error.message : String(error), undefined, error);
+    }
+    finally {
+        this.disposed();
+    } }
+    diagnostics() { return [...this.messages]; }
+    installHandlers() {
+        const notificationSchemas = [ProgressNotificationSchema, LoggingMessageNotificationSchema, ResourceUpdatedNotificationSchema, ResourceListChangedNotificationSchema, ToolListChangedNotificationSchema, PromptListChangedNotificationSchema, TaskStatusNotificationSchema];
+        for (const schema of notificationSchemas)
+            this.client.setNotificationHandler(schema, (notification) => this.pushEvent(notification.method, notification.params));
+        this.client.setRequestHandler(ListRootsRequestSchema, async () => ({ roots: this.behavior.roots ?? [] }));
+        this.client.setRequestHandler(CreateMessageRequestSchema, async () => ({ model: this.behavior.sampling?.model ?? "mcprigor-fixture", role: "assistant", content: { type: "text", text: this.behavior.sampling?.text ?? "deterministic response" }, stopReason: "endTurn" }));
+        this.client.setRequestHandler(ElicitRequestSchema, async () => ({ action: this.behavior.elicitation?.action ?? "decline", ...(this.behavior.elicitation?.content ? { content: this.behavior.elicitation.content } : {}) }));
+    }
+    pushEvent(method, params) { const event = { method, params, sequence: ++this.sequence }; this.nativeEvents.push(event); for (const waiter of this.waiters.filter((item) => item.method === method)) {
+        clearTimeout(waiter.timer);
+        waiter.resolve(structuredClone(event));
+    } this.waiters = this.waiters.filter((item) => item.method !== method); }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/snapshots.d.ts

@@ -0,0 +1,28 @@
+export interface SnapshotFile {
+    schemaVersion: 1;
+    snapshots: Record<string, unknown>;
+}
+export interface SnapshotOptions {
+    file: string;
+    update?: boolean;
+    ignore?: string[];
+}
+export declare class SnapshotStore {
+    private readonly options;
+    private data;
+    private dirty;
+    constructor(options: SnapshotOptions);
+    load(): Promise<void>;
+    match(name: string, actual: unknown, ignore?: string[]): void;
+    save(): Promise<void>;
+}
+export interface SemanticChange {
+    path: string;
+    kind: "added" | "removed" | "changed";
+    before?: unknown;
+    after?: unknown;
+}
+export declare function semanticDiff(before: unknown, after: unknown, path?: string, changes?: SemanticChange[]): SemanticChange[];
+export declare function renderSemanticDiff(changes: SemanticChange[]): string;
+export declare function normalizeSnapshot(value: unknown, ignore: string[]): unknown;
+//# sourceMappingURL=snapshots.d.ts.map

package/dist/snapshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.d.ts","sourceRoot":"","sources":["../src/snapshots.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAAG,aAAa,EAAE,CAAC,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;AACtF,MAAM,WAAW,eAAe;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE;AAEtF,qBAAa,aAAa;IAEZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IADpC,OAAO,CAAC,IAAI,CAAqD;IAAC,OAAO,CAAC,KAAK,CAAS;gBAC3D,OAAO,EAAE,eAAe;IAC/C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAC3B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAE,MAAM,EAAO,GAAG,IAAI;IAM3D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE;AAC1H,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,SAAM,EAAE,OAAO,GAAE,cAAc,EAAO,GAAG,cAAc,EAAE,CAK1H;AACD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAAqS;AAC1W,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAA0H"}

package/dist/snapshots.js

@@ -0,0 +1,87 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { canonicalize } from "./canonical.js";
+export class SnapshotStore {
+    options;
+    data = { schemaVersion: 1, snapshots: {} };
+    dirty = false;
+    constructor(options) {
+        this.options = options;
+    }
+    async load() { try {
+        const value = JSON.parse(await readFile(resolve(this.options.file), "utf8"));
+        if (value.schemaVersion !== 1 || !value.snapshots)
+            throw new Error("invalid format");
+        this.data = value;
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw new Error(`MCP-SNAPSHOT-001 Cannot load snapshot: ${error instanceof Error ? error.message : String(error)}`);
+    } }
+    match(name, actual, ignore = []) {
+        const normalized = normalizeSnapshot(actual, [...(this.options.ignore ?? []), ...ignore]);
+        if (!(name in this.data.snapshots)) {
+            if (!this.options.update)
+                throw new Error(`MCP-SNAPSHOT-002 Snapshot “${name}” does not exist. Re-run with --update-snapshots.`);
+            this.data.snapshots[name] = normalized;
+            this.dirty = true;
+            return;
+        }
+        const expected = this.data.snapshots[name];
+        const changes = semanticDiff(expected, normalized);
+        if (changes.length) {
+            if (this.options.update) {
+                this.data.snapshots[name] = normalized;
+                this.dirty = true;
+                return;
+            }
+            throw new Error(`MCP-SNAPSHOT-003 Snapshot “${name}” changed:\n${renderSemanticDiff(changes)}`);
+        }
+    }
+    async save() { if (!this.dirty)
+        return; const file = resolve(this.options.file); await mkdir(dirname(file), { recursive: true }); await writeFile(file, JSON.stringify(canonicalize(this.data), null, 2) + "\n", "utf8"); }
+}
+export function semanticDiff(before, after, path = "$", changes = []) {
+    if (Object.is(before, after))
+        return changes;
+    if (Array.isArray(before) && Array.isArray(after)) {
+        const length = Math.max(before.length, after.length);
+        for (let i = 0; i < length; i++) {
+            if (i >= before.length)
+                changes.push({ path: `${path}[${i}]`, kind: "added", after: after[i] });
+            else if (i >= after.length)
+                changes.push({ path: `${path}[${i}]`, kind: "removed", before: before[i] });
+            else
+                semanticDiff(before[i], after[i], `${path}[${i}]`, changes);
+        }
+        return changes;
+    }
+    if (record(before) && record(after)) {
+        const keys = [...new Set([...Object.keys(before), ...Object.keys(after)])].sort();
+        for (const key of keys) {
+            if (!(key in before))
+                changes.push({ path: `${path}.${key}`, kind: "added", after: after[key] });
+            else if (!(key in after))
+                changes.push({ path: `${path}.${key}`, kind: "removed", before: before[key] });
+            else
+                semanticDiff(before[key], after[key], `${path}.${key}`, changes);
+        }
+        return changes;
+    }
+    changes.push({ path, kind: "changed", before, after });
+    return changes;
+}
+export function renderSemanticDiff(changes) { return changes.map((item) => item.kind === "added" ? `+ ${item.path}: ${JSON.stringify(item.after)}` : item.kind === "removed" ? `- ${item.path}: ${JSON.stringify(item.before)}` : `- ${item.path}: ${JSON.stringify(item.before)}\n+ ${item.path}: ${JSON.stringify(item.after)}`).join("\n"); }
+export function normalizeSnapshot(value, ignore) { const clone = structuredClone(value); for (const path of ignore)
+    removePath(clone, path); return canonicalize(clone); }
+function removePath(value, path) { if (!path.startsWith("$.") || !record(value))
+    return; const parts = path.slice(2).replace(/\[(\d+)\]/g, ".$1").split("."); let current = value; for (let i = 0; i < parts.length - 1; i++) {
+    current = current?.[parts[i]];
+    if (current == null)
+        return;
+} if (Array.isArray(current))
+    current.splice(Number(parts.at(-1)), 1);
+else if (record(current))
+    delete current[parts.at(-1)]; }
+function record(value) { return typeof value === "object" && value !== null && !Array.isArray(value); }
+//# sourceMappingURL=snapshots.js.map

package/dist/snapshots.js.map

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

package/dist/starter.d.ts

@@ -0,0 +1,3 @@
+export declare const starterTemplate = "# MCP Rigor \u2014 plain-language acceptance tests\nSuite: \"My MCP server\"\n\n# For a local server:\nServer: node dist/server.js\n\n# Or replace the line above with:\n# MCP URL: http://localhost:3000/mcp\n\nTest: \"The calculator adds two numbers\"\n  Require: tools\n\n  Call tool \"add\" with:\n    a: 2\n    b: 3\n\n  Expect \"structuredContent.sum\" equals 5\n  Save \"structuredContent.sum\" as \"answer\"\n";
+export declare function writeStarter(file: string, force?: boolean): Promise<void>;
+//# sourceMappingURL=starter.d.ts.map

package/dist/starter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starter.d.ts","sourceRoot":"","sources":["../src/starter.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,maAkB3B,CAAC;AAEF,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ7E"}

package/dist/starter.js

@@ -0,0 +1,34 @@
+import { access, writeFile } from "node:fs/promises";
+export const starterTemplate = `# MCP Rigor — plain-language acceptance tests
+Suite: "My MCP server"
+
+# For a local server:
+Server: node dist/server.js
+
+# Or replace the line above with:
+# MCP URL: http://localhost:3000/mcp
+
+Test: "The calculator adds two numbers"
+  Require: tools
+
+  Call tool "add" with:
+    a: 2
+    b: 3
+
+  Expect "structuredContent.sum" equals 5
+  Save "structuredContent.sum" as "answer"
+`;
+export async function writeStarter(file, force = false) {
+    if (!force) {
+        try {
+            await access(file);
+            throw new Error(`QA-INIT-001 ${file} already exists. Choose another name or add --force.`);
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.startsWith("QA-INIT-001"))
+                throw error;
+        }
+    }
+    await writeFile(file, starterTemplate, "utf8");
+}
+//# sourceMappingURL=starter.js.map

package/dist/starter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"starter.js","sourceRoot":"","sources":["../src/starter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;CAkB9B,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,KAAK,GAAG,KAAK;IAC5D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,IAAI,CAAC;YAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YAAC,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,sDAAsD,CAAC,CAAC;QAAC,CAAC;QACvH,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC;gBAAE,MAAM,KAAK,CAAC;QACrF,CAAC;IACH,CAAC;IACD,MAAM,SAAS,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC"}

package/dist/state.d.ts

@@ -0,0 +1,13 @@
+import type { Target } from "./types.js";
+export interface PersistedState {
+    formatVersion: 1;
+    createdAt: string;
+    targetFingerprint: string;
+    suiteFingerprint: string;
+    outputs: Record<string, unknown>;
+    integrity: string;
+}
+export declare function targetFingerprint(target: Target): string;
+export declare function readState(file: string, target: Target, allowTargetMismatch?: boolean): Promise<PersistedState>;
+export declare function writeState(file: string, target: Target, suite: unknown, outputs: Record<string, unknown>): Promise<void>;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,CAAC,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,UAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,CAQlH;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAO9H"}

package/dist/state.js

@@ -0,0 +1,29 @@
+import { chmod, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname, basename, join } from "node:path";
+import { fingerprint } from "./canonical.js";
+export function targetFingerprint(target) {
+    if (target.transport === "stdio")
+        return fingerprint({ transport: target.transport, command: target.command, args: target.args ?? [], cwd: target.cwd });
+    return fingerprint({ transport: target.transport, url: target.url });
+}
+export async function readState(file, target, allowTargetMismatch = false) {
+    const value = JSON.parse(await readFile(file, "utf8"));
+    if (value.formatVersion !== 1 || typeof value.outputs !== "object" || !value.outputs)
+        throw new Error("MCP-STATE-001 State file format is invalid");
+    const expectedIntegrity = fingerprint({ ...value, integrity: undefined });
+    if (value.integrity !== expectedIntegrity)
+        throw new Error("MCP-STATE-002 State file integrity check failed");
+    const current = targetFingerprint(target);
+    if (!allowTargetMismatch && value.targetFingerprint !== current)
+        throw new Error("MCP-STATE-003 State file belongs to a different MCP target. Use --allow-state-target-mismatch only after reviewing it.");
+    return value;
+}
+export async function writeState(file, target, suite, outputs) {
+    const core = { formatVersion: 1, createdAt: new Date().toISOString(), targetFingerprint: targetFingerprint(target), suiteFingerprint: fingerprint(suite), outputs };
+    const value = { ...core, integrity: fingerprint({ ...core, integrity: undefined }) };
+    const temporary = join(dirname(file), `.${basename(file)}.${process.pid}.tmp`);
+    await writeFile(temporary, `${JSON.stringify(value, null, 2)}\n`, { encoding: "utf8", mode: 0o600 });
+    await chmod(temporary, 0o600);
+    await rename(temporary, file);
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAY7C,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,IAAI,MAAM,CAAC,SAAS,KAAK,OAAO;QAAE,OAAO,WAAW,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IACzJ,OAAO,WAAW,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,MAAc,EAAE,mBAAmB,GAAG,KAAK;IACvF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAmB,CAAC;IACzE,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IACpJ,MAAM,iBAAiB,GAAG,WAAW,CAAC,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;IAC1E,IAAI,KAAK,CAAC,SAAS,KAAK,iBAAiB;QAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IAC9G,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,CAAC,mBAAmB,IAAI,KAAK,CAAC,iBAAiB,KAAK,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,wHAAwH,CAAC,CAAC;IAC3M,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,MAAc,EAAE,KAAc,EAAE,OAAgC;IAC7G,MAAM,IAAI,GAAG,EAAE,aAAa,EAAE,CAAU,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,iBAAiB,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAAE,gBAAgB,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAC7K,MAAM,KAAK,GAAmB,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACrG,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;IAC/E,MAAM,SAAS,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACrG,MAAM,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC9B,MAAM,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC"}

package/dist/trace.d.ts

@@ -0,0 +1,57 @@
+import { type Redactor } from "./redact.js";
+import type { RunResult, Target, TestSession } from "./types.js";
+export type TraceEventType = "session.connect.start" | "session.connect.success" | "request" | "response" | "error" | "session.close" | "diagnostic";
+export interface TraceEvent {
+    schemaVersion: 1;
+    sequence: number;
+    elapsedMs: number;
+    type: TraceEventType;
+    testId?: string;
+    step?: string;
+    requestId?: string;
+    method?: string;
+    data?: unknown;
+}
+export interface NormalizedTraceEvent {
+    schemaVersion: 1;
+    sequence: number;
+    type: TraceEventType;
+    testId?: string;
+    step?: string;
+    requestId?: string;
+    method?: string;
+    data?: unknown;
+}
+export interface EvidenceManifest {
+    schemaVersion: 1;
+    frameworkVersion: string;
+    createdAt: string;
+    suiteName: string;
+    status: RunResult["status"];
+    resultHash: string;
+    traceHash: string;
+    normalizedTraceHash: string;
+    files: Record<string, string>;
+    target: {
+        transport: Target["transport"];
+    };
+}
+export declare class TraceRecorder {
+    private readonly redactor;
+    private readonly started;
+    private sequence;
+    private request;
+    readonly events: TraceEvent[];
+    constructor(redactor?: Redactor);
+    record(type: TraceEventType, fields?: Omit<TraceEvent, "schemaVersion" | "sequence" | "elapsedMs" | "type">): TraceEvent;
+    nextRequestId(): string;
+    normalized(): NormalizedTraceEvent[];
+}
+export declare function traceSession(session: TestSession, recorder: TraceRecorder, context: () => {
+    testId?: string;
+    step?: string;
+}): TestSession;
+export declare function writeEvidenceBundle(directory: string, result: RunResult, target: Target, recorder: TraceRecorder): Promise<EvidenceManifest>;
+export declare function showEvidence(directory: string): Promise<string>;
+export declare function compareEvidence(first: string, second: string): Promise<string>;
+//# sourceMappingURL=trace.d.ts.map

package/dist/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9E,MAAM,MAAM,cAAc,GAAG,uBAAuB,GAAG,yBAAyB,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,eAAe,GAAG,YAAY,CAAC;AACrJ,MAAM,WAAW,UAAU;IAAG,aAAa,EAAE,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE;AAChM,MAAM,WAAW,oBAAoB;IAAG,aAAa,EAAE,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE;AACvL,MAAM,WAAW,gBAAgB;IAAG,aAAa,EAAE,CAAC,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,CAAA;KAAE,CAAA;CAAE;AAElS,qBAAa,aAAa;IAGZ,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IAAC,OAAO,CAAC,QAAQ,CAAK;IAAC,OAAO,CAAC,OAAO,CAAK;IACjF,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,CAAM;gBACN,QAAQ,GAAE,QAA2B;IAClE,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,GAAE,IAAI,CAAC,UAAU,EAAE,eAAe,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,CAAM,GAAG,UAAU;IAG5H,aAAa,IAAI,MAAM;IACvB,UAAU,IAAI,oBAAoB,EAAE;CACrC;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,CAc1I;AAED,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CASlJ;AAED,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIrE;AACD,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIpF"}

package/dist/trace.js

@@ -0,0 +1,94 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { basename, join, resolve } from "node:path";
+import { canonicalize, fingerprint } from "./canonical.js";
+import { createRedactor } from "./redact.js";
+export class TraceRecorder {
+    redactor;
+    started = Date.now();
+    sequence = 0;
+    request = 0;
+    events = [];
+    constructor(redactor = createRedactor()) {
+        this.redactor = redactor;
+    }
+    record(type, fields = {}) {
+        const event = this.redactor.value({ schemaVersion: 1, sequence: ++this.sequence, elapsedMs: Date.now() - this.started, type, ...fields });
+        this.events.push(event);
+        return event;
+    }
+    nextRequestId() { return `request-${++this.request}`; }
+    normalized() { return this.events.map(({ elapsedMs: _elapsed, ...event }) => canonicalize(normalizeVolatile(event))); }
+}
+export function traceSession(session, recorder, context) {
+    return {
+        async connect() { recorder.record("session.connect.start", context()); try {
+            const info = await session.connect();
+            recorder.record("session.connect.success", { ...context(), data: info });
+            return info;
+        }
+        catch (error) {
+            recorder.record("error", { ...context(), data: safeError(error) });
+            throw error;
+        } },
+        async request(method, params, timeoutMs) { const requestId = recorder.nextRequestId(); recorder.record("request", { ...context(), requestId, method, data: { params, timeoutMs } }); try {
+            const response = await session.request(method, params, timeoutMs);
+            recorder.record("response", { ...context(), requestId, method, data: response });
+            return response;
+        }
+        catch (error) {
+            recorder.record("error", { ...context(), requestId, method, data: safeError(error) });
+            throw error;
+        } },
+        async close() { try {
+            await session.close();
+        }
+        finally {
+            recorder.record("session.close", context());
+            for (const message of session.diagnostics())
+                recorder.record("diagnostic", { ...context(), data: message });
+        } },
+        nativeRequest: session.nativeRequest ? (method, params, options) => session.nativeRequest(method, params, options) : undefined,
+        events: session.events ? () => session.events() : undefined,
+        awaitEvent: session.awaitEvent ? (method, timeoutMs) => session.awaitEvent(method, timeoutMs) : undefined,
+        subscribe: session.subscribe ? (uri) => session.subscribe(uri) : undefined,
+        unsubscribe: session.unsubscribe ? (uri) => session.unsubscribe(uri) : undefined,
+        setLoggingLevel: session.setLoggingLevel ? (level) => session.setLoggingLevel(level) : undefined,
+        configureClient: session.configureClient ? (behavior) => session.configureClient(behavior) : undefined,
+        diagnostics: () => session.diagnostics(),
+    };
+}
+export async function writeEvidenceBundle(directory, result, target, recorder) {
+    const root = resolve(directory);
+    await mkdir(root, { recursive: true });
+    const raw = recorder.events.map((event) => JSON.stringify(event)).join("\n") + "\n";
+    const normalizedEvents = recorder.normalized();
+    const normalized = normalizedEvents.map((event) => JSON.stringify(event)).join("\n") + "\n";
+    const files = { result: "result.json", trace: "trace.jsonl", normalizedTrace: "trace.normalized.jsonl", manifest: "manifest.json" };
+    const manifestCore = { schemaVersion: 1, frameworkVersion: "1.0.0-rc.1", createdAt: new Date().toISOString(), suiteName: result.suiteName, status: result.status, resultHash: result.evidenceHash, traceHash: fingerprint(recorder.events), normalizedTraceHash: fingerprint(normalizedEvents), files, target: { transport: target.transport } };
+    const manifest = manifestCore;
+    await Promise.all([writeFile(join(root, files.result), JSON.stringify(result, null, 2) + "\n"), writeFile(join(root, files.trace), raw), writeFile(join(root, files.normalizedTrace), normalized), writeFile(join(root, files.manifest), JSON.stringify(manifest, null, 2) + "\n")]);
+    return manifest;
+}
+export async function showEvidence(directory) {
+    const manifest = JSON.parse(await readFile(join(resolve(directory), "manifest.json"), "utf8"));
+    const result = JSON.parse(await readFile(join(resolve(directory), manifest.files.result), "utf8"));
+    return [`Evidence: ${basename(resolve(directory))}`, `Suite: ${manifest.suiteName}`, `Status: ${manifest.status}`, `Tests: ${result.summary.passed} passed, ${result.summary.failed} failed, ${result.summary.blocked} blocked`, `Result: ${manifest.resultHash}`, `Normalized trace: ${manifest.normalizedTraceHash}`].join("\n");
+}
+export async function compareEvidence(first, second) {
+    const a = JSON.parse(await readFile(join(resolve(first), "manifest.json"), "utf8"));
+    const b = JSON.parse(await readFile(join(resolve(second), "manifest.json"), "utf8"));
+    if (a.normalizedTraceHash === b.normalizedTraceHash && a.resultHash === b.resultHash)
+        return "Evidence bundles are semantically identical.";
+    const lines = ["Evidence bundles differ:"];
+    if (a.resultHash !== b.resultHash)
+        lines.push(`- Result hash: ${a.resultHash} → ${b.resultHash}`);
+    if (a.normalizedTraceHash !== b.normalizedTraceHash)
+        lines.push(`- Trace hash: ${a.normalizedTraceHash} → ${b.normalizedTraceHash}`);
+    return lines.join("\n");
+}
+function normalizeVolatile(value) { if (Array.isArray(value))
+    return value.map(normalizeVolatile); if (!value || typeof value !== "object")
+    return typeof value === "string" ? value.replace(/\/var\/folders\/[^\s"']+/g, "<temp-path>").replace(/\/tmp\/[^\s"']+/g, "<temp-path>") : value; return Object.fromEntries(Object.entries(value).filter(([key]) => !/timestamp|createdAt|sessionId/i.test(key)).map(([key, item]) => [key, normalizeVolatile(item)])); }
+function safeError(error) { if (!(error instanceof Error))
+    return { message: String(error) }; const candidate = error; return { name: error.name, message: error.message, code: candidate.code, data: candidate.data }; }
+//# sourceMappingURL=trace.js.map

package/dist/trace.js.map

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