@ontrails/testing 1.0.0-beta.2 → 1.0.0-beta.21

package/dist/logger.js

@@ -1,87 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E,MAAM,WAAW,GAA2B;IAC1C,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;IACT,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;CACR,CAAC;AAEF,8EAA8E;AAC9E,2DAA2D;AAC3D,8EAA8E;AAE9E,MAAM,wBAAwB,GAAG,CAC/B,IAAY,EACZ,QAAkB,EAClB,aAA0B,EAC1B,YAAyB,EACb,EAAE;IACd,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE5C,MAAM,SAAS,GAAG,CAAC,KAAe,EAAW,EAAE,CAC7C,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,QAAQ,CAAC;IAExC,MAAM,GAAG,GAAG,CACV,KAAe,EACf,OAAe,EACf,QAAsB,EAChB,EAAE;QACR,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAc;YACxB,QAAQ,EAAE,IAAI;YACd,KAAK;YACL,OAAO;YACP,QAAQ,EAAE,EAAE,GAAG,YAAY,EAAE,GAAG,QAAQ,EAAE;YAC1C,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;QACF,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC,CAAC;IAEF,OAAO;QACL,YAAY,CAAC,KAAe,EAAE,gBAAwB;YACpD,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CACjE,CAAC;YACF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CACb,oCAAoC,KAAK,iBAAiB,gBAAgB,yBAAyB;oBACjG,YAAY,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CACnG,CAAC;YACJ,CAAC;QACH,CAAC;QAED,KAAK,CAAC,QAAqB;YACzB,MAAM,MAAM,GAAG,EAAE,GAAG,YAAY,EAAE,GAAG,QAAQ,EAAE,CAAC;YAChD,OAAO,wBAAwB,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;QACzE,CAAC;QAED,KAAK;YACH,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3B,CAAC;QAED,KAAK,CAAC,OAAe,EAAE,QAAsB;YAC3C,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;QAED,IAAI,OAAO;YACT,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,KAAK,CAAC,OAAe,EAAE,QAAsB;YAC3C,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;QAED,KAAK,CAAC,OAAe,EAAE,QAAsB;YAC3C,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;QAED,IAAI,CAAC,SAAyC;YAC5C,OAAO,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,CAAC,OAAe,EAAE,QAAsB;YAC1C,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QACjC,CAAC;QAED,IAAI;QAEJ,KAAK,CAAC,OAAe,EAAE,QAAsB;YAC3C,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAClC,CAAC;QAED,IAAI,CAAC,OAAe,EAAE,QAAsB;YAC1C,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QACjC,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAA8B,EAAc,EAAE,CAC7E,wBAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC"}

package/dist/trail.d.ts

@@ -1,20 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,80 +0,0 @@
-/**
- * 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

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

package/dist/types.d.ts

@@ -1,80 +0,0 @@
-/**
- * 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

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

package/dist/types.js

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

package/dist/types.js.map

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

package/src/__tests__/context.test.ts

@@ -1,60 +0,0 @@
-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' });
-  });
-});

package/src/__tests__/contracts.test.ts

@@ -1,68 +0,0 @@
-import { describe, test } from 'bun:test';
-
-import { Result, trail, topo } from '@ontrails/core';
-import { z } from 'zod';
-
-import { testContracts } from '../contracts.js';
-
-// ---------------------------------------------------------------------------
-// Test trails
-// ---------------------------------------------------------------------------
-
-/** Trail whose implementation matches the output schema. */
-const validTrail = trail('valid', {
-  examples: [
-    {
-      expected: { id: 1, name: 'Alpha' },
-      input: { name: 'Alpha' },
-      name: 'Valid output',
-    },
-  ],
-  implementation: (input: { name: string }) =>
-    Result.ok({ id: 1, name: input.name }),
-  input: z.object({ name: z.string() }),
-  output: z.object({ id: z.number(), name: z.string() }),
-});
-
-/** Trail without output schema -- should be skipped. */
-const noSchemaTrail = trail('noschema', {
-  examples: [{ expected: 10, input: { x: 5 }, name: 'No schema' }],
-  implementation: (input: { x: number }) => Result.ok(input.x * 2),
-  input: z.object({ x: z.number() }),
-});
-
-/** Trail without examples -- should be skipped. */
-const noExamplesTrail = trail('noexamples', {
-  implementation: (input: { x: number }) => Result.ok({ value: input.x }),
-  input: z.object({ x: z.number() }),
-  output: z.object({ value: z.number() }),
-});
-
-// ---------------------------------------------------------------------------
-// Tests
-// ---------------------------------------------------------------------------
-
-describe('testContracts: valid output matches schema', () => {
-  // eslint-disable-next-line jest/require-hook
-  testContracts(topo('test-app', { validTrail } as Record<string, unknown>));
-});
-
-describe('testContracts: skips trails without output schemas', () => {
-  // eslint-disable-next-line jest/require-hook
-  testContracts(topo('test-app', { noSchemaTrail } as Record<string, unknown>));
-
-  test('no-op marker', () => {
-    // Trail without output schema is skipped -- no contract tests generated
-  });
-});
-
-describe('testContracts: skips trails without examples', () => {
-  // eslint-disable-next-line jest/require-hook
-  testContracts(
-    topo('test-app', { noExamplesTrail } as Record<string, unknown>)
-  );
-
-  test('no-op marker', () => {
-    // Trail without examples is skipped -- no contract tests generated
-  });
-});

package/src/__tests__/detours.test.ts

@@ -1,55 +0,0 @@
-import { describe, test } from 'bun:test';
-
-import { Result, trail, topo } from '@ontrails/core';
-import { z } from 'zod';
-
-import { testDetours } from '../detours.js';
-
-// ---------------------------------------------------------------------------
-// Test trails
-// ---------------------------------------------------------------------------
-
-const showTrail = trail('entity.show', {
-  detours: {
-    related: ['entity.list'],
-  },
-  implementation: (input: { id: string }) => Result.ok({ id: input.id }),
-  input: z.object({ id: z.string() }),
-});
-
-const listTrail = trail('entity.list', {
-  implementation: () => Result.ok([]),
-  input: z.object({}),
-});
-
-const noDetoursTrail = trail('entity.plain', {
-  implementation: () => Result.ok('ok'),
-  input: z.object({}),
-});
-
-// ---------------------------------------------------------------------------
-// Tests
-// ---------------------------------------------------------------------------
-
-describe('testDetours: all targets exist', () => {
-  // eslint-disable-next-line jest/require-hook
-  testDetours(
-    topo('test-app', {
-      listTrail,
-      showTrail,
-    } as Record<string, unknown>)
-  );
-});
-
-describe('testDetours: skips trails without detours', () => {
-  // eslint-disable-next-line jest/require-hook
-  testDetours(
-    topo('test-app', {
-      noDetoursTrail,
-    } as Record<string, unknown>)
-  );
-
-  test('no-op marker', () => {
-    // Trail without detours is skipped -- no detour tests generated
-  });
-});

package/src/__tests__/examples.test.ts

@@ -1,176 +0,0 @@
-import { describe, test } from 'bun:test';
-
-import { NotFoundError, Result, hike, trail, topo } from '@ontrails/core';
-import { z } from 'zod';
-
-import { testExamples } from '../examples.js';
-
-// ---------------------------------------------------------------------------
-// Test trails
-// ---------------------------------------------------------------------------
-
-const greetTrail = trail('greet', {
-  description: 'Greet someone',
-  examples: [
-    {
-      expected: { greeting: 'Hello, Alice' },
-      input: { name: 'Alice' },
-      name: 'Greet Alice',
-    },
-  ],
-  implementation: (input: { name: string }) =>
-    Result.ok({ greeting: `Hello, ${input.name}` }),
-  input: z.object({ name: z.string() }),
-  output: z.object({ greeting: z.string() }),
-});
-
-const searchTrail = trail('search', {
-  description: 'Search for things',
-  examples: [
-    {
-      input: { query: 'test' },
-      name: 'Schema-only search',
-    },
-  ],
-  implementation: (input: { query: string }) =>
-    Result.ok({ results: [`result for ${input.query}`] }),
-  input: z.object({ query: z.string() }),
-  output: z.object({ results: z.array(z.string()) }),
-});
-
-const entityTrail = trail('entity.show', {
-  description: 'Show entity',
-  examples: [
-    {
-      expected: { id: 1, name: 'Alpha' },
-      input: { name: 'Alpha' },
-      name: 'Show entity by name',
-    },
-    {
-      error: 'NotFoundError',
-      input: { name: 'missing' },
-      name: 'Entity not found returns NotFoundError',
-    },
-  ],
-  implementation: (input: { name: string }) => {
-    if (input.name === 'missing') {
-      return Result.err(new NotFoundError('Entity not found'));
-    }
-    return Result.ok({ id: 1, name: input.name });
-  },
-  input: z.object({ name: z.string() }),
-  output: z.object({ id: z.number(), name: z.string() }),
-});
-
-const noExamplesTrail = trail('noexamples', {
-  implementation: (input: { x: number }) => Result.ok(input.x * 2),
-  input: z.object({ x: z.number() }),
-});
-
-// ---------------------------------------------------------------------------
-// Test hikes (for follows coverage)
-// ---------------------------------------------------------------------------
-
-const addTrail = trail('entity.add', {
-  description: 'Add an entity',
-  implementation: (input: { name: string }) =>
-    Result.ok({ id: '1', name: input.name }),
-  input: z.object({ name: z.string() }),
-  output: z.object({ id: z.string(), name: z.string() }),
-});
-
-const relateTrail = trail('entity.relate', {
-  description: 'Relate entities',
-  implementation: (input: { from: string; to: string }) =>
-    Result.ok({ from: input.from, to: input.to }),
-  input: z.object({ from: z.string(), to: z.string() }),
-  output: z.object({ from: z.string(), to: z.string() }),
-});
-
-const onboardHike = hike('entity.onboard', {
-  description: 'Onboard a new entity',
-  examples: [
-    {
-      expected: { id: '1', name: 'Alpha' },
-      input: { name: 'Alpha' },
-      name: 'Onboard Alpha',
-    },
-  ],
-  follows: ['entity.add', 'entity.relate'],
-  implementation: async (input: { name: string }, ctx) => {
-    if (!ctx.follow) {
-      return Result.err(new Error('follow not available'));
-    }
-    const addResult = await ctx.follow('entity.add', input);
-    if (addResult.isErr()) {
-      return addResult;
-    }
-    const relateResult = await ctx.follow('entity.relate', {
-      from: 'root',
-      to: (addResult.value as { id: string }).id,
-    });
-    if (relateResult.isErr()) {
-      return relateResult;
-    }
-    return Result.ok({ id: '1', name: input.name });
-  },
-  input: z.object({ name: z.string() }),
-  output: z.object({ id: z.string(), name: z.string() }),
-});
-
-// ---------------------------------------------------------------------------
-// Tests
-// ---------------------------------------------------------------------------
-
-describe('testExamples', () => {
-  // eslint-disable-next-line jest/require-hook
-  testExamples(
-    topo('test-app', {
-      entityTrail,
-      greetTrail,
-      noExamplesTrail,
-      searchTrail,
-    } as Record<string, unknown>)
-  );
-
-  // Also test with custom context (static form)
-  describe('with custom context', () => {
-    // eslint-disable-next-line jest/require-hook
-    testExamples(topo('ctx-app', { greetTrail } as Record<string, unknown>), {
-      requestId: 'custom-request',
-    });
-  });
-
-  // Test with factory form (each test gets a fresh context)
-  describe('with context factory', () => {
-    // eslint-disable-next-line jest/require-hook
-    testExamples(
-      topo('factory-app', { greetTrail } as Record<string, unknown>),
-      () => ({ requestId: `factory-${crypto.randomUUID()}` })
-    );
-  });
-});
-
-describe('testExamples skips trails with no examples', () => {
-  // eslint-disable-next-line jest/require-hook
-  testExamples(
-    topo('skip-app', {
-      noExamplesTrail,
-    } as Record<string, unknown>)
-  );
-
-  test('no-op marker', () => {
-    // This test exists so the describe block is not empty
-  });
-});
-
-describe('testExamples follows coverage for hikes', () => {
-  // eslint-disable-next-line jest/require-hook
-  testExamples(
-    topo('hike-app', {
-      addTrail,
-      onboardHike,
-      relateTrail,
-    } as Record<string, unknown>)
-  );
-});