@ontrails/testing 1.0.0-beta.0

package/dist/hike.js

@@ -0,0 +1,169 @@
+/**
+ * testHike — composition-aware scenario testing for hikes.
+ *
+ * Tests the composition graph: which trails were followed, in what order,
+ * and supports failure injection from followed trail examples.
+ */
+import { describe, expect, test } from 'bun:test';
+import { InternalError, Result, ValidationError, validateInput, } from '@ontrails/core';
+import { assertErrorMatch, assertFullMatch, assertSchemaMatch, expectOk, } from './assertions.js';
+import { mergeTestContext } from './context.js';
+// ---------------------------------------------------------------------------
+// Injection helpers
+// ---------------------------------------------------------------------------
+/**
+ * Find an error example on a trail by name or description substring.
+ */
+const findErrorExample = (trailDef, description) => {
+    const example = trailDef.examples?.find((ex) => ex.error !== undefined &&
+        (ex.description?.includes(description) || ex.name.includes(description)));
+    return example?.error;
+};
+/**
+ * Try to inject an error from a followed trail's example.
+ * Returns undefined when no injection is configured for this trail ID.
+ */
+const tryInjectError = (id, scenario, trailsMap) => {
+    const injection = scenario.injectFromExample?.[id];
+    if (injection === undefined) {
+        return undefined;
+    }
+    const trailDef = trailsMap?.get(id);
+    if (trailDef === undefined) {
+        return Result.err(new InternalError(`Cannot inject: trail "${id}" not in topo`));
+    }
+    const errorName = findErrorExample(trailDef, injection);
+    if (errorName === undefined) {
+        return Result.err(new InternalError(`No error example matching "${injection}" on trail "${id}"`));
+    }
+    return Result.err(new Error(errorName));
+};
+/**
+ * Execute a trail from the map, validating input first.
+ */
+const executeFromMap = (id, input, trailsMap, ctx) => {
+    const trailDef = trailsMap?.get(id);
+    if (trailDef === undefined) {
+        return undefined;
+    }
+    const validated = validateInput(trailDef.input, input);
+    if (validated.isErr()) {
+        return validated;
+    }
+    return trailDef.implementation(validated.value, ctx);
+};
+// ---------------------------------------------------------------------------
+// Follow factory
+// ---------------------------------------------------------------------------
+/**
+ * Build a recording follow function that optionally injects errors.
+ */
+const createRecordingFollow = (trace, scenario, trailsMap, baseFollow, ctx) => {
+    // The generic O on FollowFn is erased at runtime; the cast is safe
+    // because callers narrow via isOk/isErr before accessing the value.
+    const follow = (id, input) => {
+        trace.push({ id, input });
+        const injected = tryInjectError(id, scenario, trailsMap);
+        if (injected !== undefined) {
+            return Promise.resolve(injected);
+        }
+        if (baseFollow !== undefined) {
+            return baseFollow(id, input);
+        }
+        const executed = executeFromMap(id, input, trailsMap, ctx);
+        if (executed !== undefined) {
+            return Promise.resolve(executed);
+        }
+        return Promise.resolve(Result.ok());
+    };
+    return follow;
+};
+// ---------------------------------------------------------------------------
+// Scenario assertions
+// ---------------------------------------------------------------------------
+const assertScenarioResult = (result, scenario, hikeDef) => {
+    if (scenario.expectValue !== undefined) {
+        assertFullMatch(result, scenario.expectValue);
+    }
+    else if (scenario.expectErr !== undefined) {
+        assertErrorMatch(result, scenario.expectErr, scenario.expectErrMessage);
+    }
+    else if (scenario.expectErrMessage !== undefined) {
+        expect(result.isErr()).toBe(true);
+        if (result.isErr()) {
+            expect(result.error.message).toContain(scenario.expectErrMessage);
+        }
+    }
+    else if (scenario.expectOk === true) {
+        expect(result.isOk()).toBe(true);
+        assertSchemaMatch(result, hikeDef.output);
+    }
+};
+const assertFollowTrace = (trace, scenario) => {
+    if (scenario.expectFollowed !== undefined) {
+        const followedIds = trace.map((r) => r.id);
+        expect(followedIds).toEqual([...scenario.expectFollowed]);
+    }
+    if (scenario.expectFollowedCount !== undefined) {
+        const counts = {};
+        for (const record of trace) {
+            counts[record.id] = (counts[record.id] ?? 0) + 1;
+        }
+        expect(counts).toEqual({ ...scenario.expectFollowedCount });
+    }
+};
+const handleValidationError = (validated, scenario) => {
+    if (!validated.isErr()) {
+        return false;
+    }
+    if (scenario.expectErr === ValidationError) {
+        expect(validated.error).toBeInstanceOf(ValidationError);
+        if (scenario.expectErrMessage !== undefined) {
+            expect(validated.error.message).toContain(scenario.expectErrMessage);
+        }
+        return true;
+    }
+    throw new Error(`Input validation failed unexpectedly: ${validated.error.message}`);
+};
+// ---------------------------------------------------------------------------
+// Scenario runner
+// ---------------------------------------------------------------------------
+const buildTestContext = (scenario, ctx, trailsMap) => {
+    const trace = [];
+    const baseCtx = mergeTestContext(ctx);
+    const follow = createRecordingFollow(trace, scenario, trailsMap, baseCtx.follow, baseCtx);
+    return { testCtx: { ...baseCtx, follow }, trace };
+};
+const runScenario = async (hikeDef, scenario, ctx, trailsMap) => {
+    const validated = validateInput(hikeDef.input, scenario.input);
+    if (handleValidationError(validated, scenario)) {
+        return;
+    }
+    const { trace, testCtx } = buildTestContext(scenario, ctx, trailsMap);
+    const result = await hikeDef.implementation(expectOk(validated), testCtx);
+    assertFollowTrace(trace, scenario);
+    assertScenarioResult(result, scenario, hikeDef);
+};
+/**
+ * Generate a describe block for a hike with one test per scenario.
+ *
+ * @example
+ * ```ts
+ * testHike(onboardHike, [
+ *   {
+ *     description: "follows add then relate",
+ *     input: { name: "Alpha" },
+ *     expectOk: true,
+ *     expectFollowed: ["entity.add", "entity.relate"],
+ *   },
+ * ]);
+ * ```
+ */
+export const testHike = (hikeDef, scenarios, options) => {
+    describe(hikeDef.id, () => {
+        test.each([...scenarios])('$description', async (scenario) => {
+            await runScenario(hikeDef, scenario, options?.ctx, options?.trails);
+        });
+    });
+};
+//# sourceMappingURL=hike.js.map

package/dist/hike.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { testAll } from './all.js';
+export { testExamples } from './examples.js';
+export { testHike } from './hike.js';
+export { testTrail } from './trail.js';
+export { testContracts } from './contracts.js';
+export { testDetours } from './detours.js';
+export { assertErrorMatch, assertFullMatch, assertSchemaMatch, expectErr, expectOk, } from './assertions.js';
+export { createTestContext } from './context.js';
+export { createTestLogger } from './logger.js';
+export { createCliHarness } from './harness-cli.js';
+export { createMcpHarness } from './harness-mcp.js';
+export type { TestHikeOptions } from './hike.js';
+export type { HikeScenario, TestScenario, TestLogger, TestTrailContextOptions, CliHarness, CliHarnessOptions, CliHarnessResult, McpHarness, McpHarnessOptions, McpHarnessResult, } from './types.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":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,SAAS,EACT,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,uBAAuB,EACvB,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+// Contract-driven testing
+export { testAll } from './all.js';
+export { testExamples } from './examples.js';
+export { testHike } from './hike.js';
+export { testTrail } from './trail.js';
+export { testContracts } from './contracts.js';
+export { testDetours } from './detours.js';
+// Assertions
+export { assertErrorMatch, assertFullMatch, assertSchemaMatch, expectErr, expectOk, } from './assertions.js';
+// Mock factories
+export { createTestContext } from './context.js';
+export { createTestLogger } from './logger.js';
+// Surface harnesses
+export { createCliHarness } from './harness-cli.js';
+export { createMcpHarness } from './harness-mcp.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,0BAA0B;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,aAAa;AACb,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,SAAS,EACT,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAEzB,iBAAiB;AACjB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,oBAAoB;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Test logger that captures log records for assertion.
+ */
+import type { LogLevel } from '@ontrails/logging';
+import type { TestLogger } from './types.js';
+/**
+ * Create a test logger that captures all log records in an array.
+ *
+ * Records are not printed. Use `entries`, `find()`, and `assertLogged()`
+ * to inspect what was logged during a test.
+ */
+export declare const createTestLogger: (options?: {
+    level?: LogLevel;
+}) => TestLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAA0B,MAAM,mBAAmB,CAAC;AAE1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA+G7C;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU;IAAE,KAAK,CAAC,EAAE,QAAQ,CAAA;CAAE,KAAG,UACG,CAAC"}

package/dist/logger.js

@@ -0,0 +1,87 @@
+/**
+ * Test logger that captures log records for assertion.
+ */
+// ---------------------------------------------------------------------------
+// Level ordering for filtering
+// ---------------------------------------------------------------------------
+const LEVEL_ORDER = {
+    debug: 1,
+    error: 4,
+    fatal: 5,
+    info: 2,
+    silent: 6,
+    trace: 0,
+    warn: 3,
+};
+// ---------------------------------------------------------------------------
+// Internal factory (shared between root and child loggers)
+// ---------------------------------------------------------------------------
+const createTestLoggerInternal = (name, minLevel, sharedEntries, baseMetadata) => {
+    const minOrder = LEVEL_ORDER[minLevel] ?? 0;
+    const shouldLog = (level) => (LEVEL_ORDER[level] ?? 0) >= minOrder;
+    const log = (level, message, metadata) => {
+        if (!shouldLog(level)) {
+            return;
+        }
+        const record = {
+            category: name,
+            level,
+            message,
+            metadata: { ...baseMetadata, ...metadata },
+            timestamp: new Date(),
+        };
+        sharedEntries.push(record);
+    };
+    return {
+        assertLogged(level, messageSubstring) {
+            const match = sharedEntries.find((r) => r.level === level && r.message.includes(messageSubstring));
+            if (match === undefined) {
+                throw new Error(`Expected a log entry with level="${level}" containing "${messageSubstring}", but none was found. ` +
+                    `Entries: ${JSON.stringify(sharedEntries.map((r) => ({ level: r.level, message: r.message })))}`);
+            }
+        },
+        child(metadata) {
+            const merged = { ...baseMetadata, ...metadata };
+            return createTestLoggerInternal(name, minLevel, sharedEntries, merged);
+        },
+        clear() {
+            sharedEntries.length = 0;
+        },
+        debug(message, metadata) {
+            log('debug', message, metadata);
+        },
+        get entries() {
+            return sharedEntries;
+        },
+        error(message, metadata) {
+            log('error', message, metadata);
+        },
+        fatal(message, metadata) {
+            log('fatal', message, metadata);
+        },
+        find(predicate) {
+            return sharedEntries.filter(predicate);
+        },
+        info(message, metadata) {
+            log('info', message, metadata);
+        },
+        name,
+        trace(message, metadata) {
+            log('trace', message, metadata);
+        },
+        warn(message, metadata) {
+            log('warn', message, metadata);
+        },
+    };
+};
+// ---------------------------------------------------------------------------
+// createTestLogger
+// ---------------------------------------------------------------------------
+/**
+ * Create a test logger that captures all log records in an array.
+ *
+ * Records are not printed. Use `entries`, `find()`, and `assertLogged()`
+ * to inspect what was logged during a test.
+ */
+export const createTestLogger = (options) => createTestLoggerInternal('test', options?.level ?? 'trace', [], {});
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/trail.d.ts

@@ -0,0 +1,20 @@
+/**
+ * testTrail — custom scenario testing for individual trails.
+ *
+ * Use this for edge cases, boundary values, and regression tests
+ * that don't belong in `examples` (which are agent-facing documentation).
+ */
+import type { AnyTrail, TrailContext } from '@ontrails/core';
+import type { TestScenario } from './types.js';
+/**
+ * Generate a describe block for a trail with one test per scenario.
+ *
+ * ```ts
+ * testTrail(myTrail, [
+ *   { description: "valid input", input: { name: "Alpha" }, expectOk: true },
+ *   { description: "missing name", input: {}, expectErr: ValidationError },
+ * ]);
+ * ```
+ */
+export declare const testTrail: (trailDef: AnyTrail, scenarios: readonly TestScenario[], ctx?: Partial<TrailContext>) => void;
+//# sourceMappingURL=trail.d.ts.map

package/dist/trail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trail.d.ts","sourceRoot":"","sources":["../src/trail.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAU,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAUrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAyE/C;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,GACpB,UAAU,QAAQ,EAClB,WAAW,SAAS,YAAY,EAAE,EAClC,MAAM,OAAO,CAAC,YAAY,CAAC,KAC1B,IASF,CAAC"}

package/dist/trail.js

@@ -0,0 +1,80 @@
+/**
+ * testTrail — custom scenario testing for individual trails.
+ *
+ * Use this for edge cases, boundary values, and regression tests
+ * that don't belong in `examples` (which are agent-facing documentation).
+ */
+import { describe, expect, test } from 'bun:test';
+import { ValidationError, validateInput } from '@ontrails/core';
+import { assertErrorMatch, assertFullMatch, assertSchemaMatch, expectOk, } from './assertions.js';
+import { mergeTestContext } from './context.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const assertScenarioResult = (result, scenario, trailDef) => {
+    if (scenario.expectValue !== undefined) {
+        assertFullMatch(result, scenario.expectValue);
+    }
+    else if (scenario.expectErr !== undefined) {
+        assertErrorMatch(result, scenario.expectErr, scenario.expectErrMessage);
+    }
+    else if (scenario.expectErrMessage !== undefined) {
+        expect(result.isErr()).toBe(true);
+        if (result.isErr()) {
+            expect(result.error.message).toContain(scenario.expectErrMessage);
+        }
+    }
+    else if (scenario.expectOk === true) {
+        expect(result.isOk()).toBe(true);
+        assertSchemaMatch(result, trailDef.output);
+    }
+};
+/**
+ * Handle input validation failure for a scenario.
+ * Returns true if the error was expected and handled.
+ * Throws if the error was unexpected.
+ */
+const handleValidationError = (validated, scenario) => {
+    if (!validated.isErr()) {
+        return false;
+    }
+    if (scenario.expectErr === ValidationError) {
+        expect(validated.error).toBeInstanceOf(ValidationError);
+        if (scenario.expectErrMessage !== undefined) {
+            expect(validated.error.message).toContain(scenario.expectErrMessage);
+        }
+        return true;
+    }
+    throw new Error(`Input validation failed unexpectedly: ${validated.error.message}`);
+};
+const runScenario = async (trailDef, scenario, ctx) => {
+    const testCtx = mergeTestContext(ctx);
+    const validated = validateInput(trailDef.input, scenario.input);
+    if (handleValidationError(validated, scenario)) {
+        return;
+    }
+    const validatedInput = expectOk(validated);
+    const result = await trailDef.implementation(validatedInput, testCtx);
+    assertScenarioResult(result, scenario, trailDef);
+};
+// ---------------------------------------------------------------------------
+// testTrail
+// ---------------------------------------------------------------------------
+/**
+ * Generate a describe block for a trail with one test per scenario.
+ *
+ * ```ts
+ * testTrail(myTrail, [
+ *   { description: "valid input", input: { name: "Alpha" }, expectOk: true },
+ *   { description: "missing name", input: {}, expectErr: ValidationError },
+ * ]);
+ * ```
+ */
+export const testTrail = (trailDef, scenarios, ctx) => {
+    describe(trailDef.id, () => {
+        test.each([...scenarios])('$description', async (scenario) => {
+            await runScenario(trailDef, scenario, ctx);
+        });
+    });
+};
+//# sourceMappingURL=trail.js.map

package/dist/trail.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Shared types for @ontrails/testing.
+ */
+import type { Logger, Topo } from '@ontrails/core';
+import type { LogLevel, LogRecord } from '@ontrails/logging';
+/** A custom test scenario for a single trail. */
+export interface TestScenario {
+    /** Description shown in test output. */
+    readonly description?: string | undefined;
+    /** Assert the result error has this message (substring match). */
+    readonly expectErrMessage?: string | undefined;
+    /** Assert the result is an error of this type. */
+    readonly expectErr?: (new (...args: never[]) => Error) | undefined;
+    /** Assert the result is ok. */
+    readonly expectOk?: boolean | undefined;
+    /** Assert the result value equals this. */
+    readonly expectValue?: unknown | undefined;
+    /** Input to pass to the implementation. */
+    readonly input: unknown;
+}
+/** A test scenario for a hike's composition graph. */
+export interface HikeScenario extends TestScenario {
+    /** Assert these trail IDs were followed, in order. */
+    readonly expectFollowed?: readonly string[] | undefined;
+    /** Assert follow counts per trail ID. */
+    readonly expectFollowedCount?: Readonly<Record<string, number>> | undefined;
+    /** Inject failure from a followed trail's example by description. */
+    readonly injectFromExample?: Readonly<Record<string, string>> | undefined;
+}
+/** A logger that captures entries for assertion in tests. */
+export interface TestLogger extends Logger {
+    /** All log records captured during the test. */
+    readonly entries: readonly LogRecord[];
+    /** Clear captured entries. */
+    clear(): void;
+    /** Find entries matching a predicate. */
+    find(predicate: (record: LogRecord) => boolean): readonly LogRecord[];
+    /** Assert that at least one entry matches. */
+    assertLogged(level: LogLevel, messageSubstring: string): void;
+}
+/** Options for creating a test trail context. */
+export interface TestTrailContextOptions {
+    readonly cwd?: string | undefined;
+    readonly env?: Record<string, string> | undefined;
+    readonly logger?: Logger | undefined;
+    readonly requestId?: string | undefined;
+    readonly signal?: AbortSignal | undefined;
+}
+/** Options for creating a CLI harness. */
+export interface CliHarnessOptions {
+    readonly app: Topo;
+}
+/** A test harness for CLI commands. */
+export interface CliHarness {
+    /** Execute a CLI command string and capture output. */
+    run(command: string): Promise<CliHarnessResult>;
+}
+/** The result of a CLI harness command execution. */
+export interface CliHarnessResult {
+    readonly exitCode: number;
+    /** Parsed JSON output if --output json was used. */
+    readonly json?: unknown | undefined;
+    readonly stderr: string;
+    readonly stdout: string;
+}
+/** Options for creating an MCP harness. */
+export interface McpHarnessOptions {
+    readonly app: Topo;
+}
+/** A test harness for MCP tools. */
+export interface McpHarness {
+    /** Call an MCP tool by name with arguments. */
+    callTool(name: string, args: Record<string, unknown>): Promise<McpHarnessResult>;
+}
+/** The result of an MCP harness tool invocation. */
+export interface McpHarnessResult {
+    readonly content: unknown;
+    readonly isError: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared types for @ontrails/testing.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@ontrails/testing",
+  "version": "1.0.0-beta.0",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint ./src",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  },
+  "peerDependencies": {
+    "@ontrails/cli": "workspace:*",
+    "@ontrails/core": "workspace:*",
+    "@ontrails/logging": "workspace:*",
+    "@ontrails/mcp": "workspace:*",
+    "zod": "catalog:"
+  }
+}

package/src/__tests__/context.test.ts

@@ -0,0 +1,60 @@
+import { describe, expect, test } from 'bun:test';
+
+import { createTestContext } from '../context.js';
+import type { TestLogger } from '../types.js';
+
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+
+describe('createTestContext', () => {
+  test('produces a valid TrailContext with no args', () => {
+    const ctx = createTestContext();
+    expect(ctx.requestId).toBe('test-request-001');
+    expect(ctx.signal).toBeDefined();
+    expect(ctx.signal.aborted).toBe(false);
+    expect(ctx.logger).toBeDefined();
+    expect(ctx.workspaceRoot).toBeDefined();
+  });
+
+  test('default logger is a TestLogger', () => {
+    const ctx = createTestContext();
+    const logger = ctx.logger as TestLogger;
+    expect(typeof logger.info).toBe('function');
+    expect(typeof logger.clear).toBe('function');
+    expect(typeof logger.find).toBe('function');
+    expect(typeof logger.assertLogged).toBe('function');
+    expect(logger.entries).toBeDefined();
+  });
+
+  test('default env is set to test', () => {
+    const ctx = createTestContext();
+    const env = ctx['env'] as Record<string, string>;
+    expect(env).toEqual({ TRAILS_ENV: 'test' });
+  });
+
+  test('overrides requestId', () => {
+    const ctx = createTestContext({ requestId: 'custom-id' });
+    expect(ctx.requestId).toBe('custom-id');
+  });
+
+  test('overrides signal', () => {
+    const controller = new AbortController();
+    controller.abort();
+    const ctx = createTestContext({ signal: controller.signal });
+    expect(ctx.signal.aborted).toBe(true);
+  });
+
+  test('overrides cwd', () => {
+    const ctx = createTestContext({ cwd: '/tmp/test' });
+    expect(ctx.workspaceRoot).toBe('/tmp/test');
+  });
+
+  test('overrides env', () => {
+    const ctx = createTestContext({
+      env: { CUSTOM: '1', NODE_ENV: 'test' },
+    });
+    const env = ctx['env'] as Record<string, string>;
+    expect(env).toEqual({ CUSTOM: '1', NODE_ENV: 'test' });
+  });
+});