@sensigo/realm-testing 0.1.0

package/dist/mocks/mock-gate.d.ts

@@ -0,0 +1,9 @@
+import { type RunStore, type WorkflowDefinition, type ResponseEnvelope } from '@sensigo/realm';
+/**
+ * Auto-responds to any open human gate on the run.
+ * Reads gate_id and step_name from run.pending_gate, looks up the choice in
+ * gateResponses[step_name], defaults to 'approve'. Calls submitHumanResponse.
+ * @throws Error if run.pending_gate is undefined.
+ */
+export declare function createGateResponder(store: RunStore, definition: WorkflowDefinition, runId: string, gateResponses: Record<string, string>): Promise<ResponseEnvelope>;
+//# sourceMappingURL=mock-gate.d.ts.map

package/dist/mocks/mock-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-gate.d.ts","sourceRoot":"","sources":["../../src/mocks/mock-gate.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AAExB;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,QAAQ,EACf,UAAU,EAAE,kBAAkB,EAC9B,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,OAAO,CAAC,gBAAgB,CAAC,CAW3B"}

package/dist/mocks/mock-gate.js

@@ -0,0 +1,21 @@
+// createGateResponder — auto-responds to open human gates in test scenarios.
+import { submitHumanResponse, } from '@sensigo/realm';
+/**
+ * Auto-responds to any open human gate on the run.
+ * Reads gate_id and step_name from run.pending_gate, looks up the choice in
+ * gateResponses[step_name], defaults to 'approve'. Calls submitHumanResponse.
+ * @throws Error if run.pending_gate is undefined.
+ */
+export async function createGateResponder(store, definition, runId, gateResponses) {
+    const run = await store.get(runId);
+    if (run.pending_gate === undefined) {
+        throw new Error('createGateResponder: run has no pending gate');
+    }
+    const choice = gateResponses[run.pending_gate.step_name] ?? 'approve';
+    return submitHumanResponse(store, definition, {
+        runId,
+        gateId: run.pending_gate.gate_id,
+        choice,
+    });
+}
+//# sourceMappingURL=mock-gate.js.map

package/dist/mocks/mock-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-gate.js","sourceRoot":"","sources":["../../src/mocks/mock-gate.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,OAAO,EACL,mBAAmB,GAIpB,MAAM,gBAAgB,CAAC;AAExB;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAAe,EACf,UAA8B,EAC9B,KAAa,EACb,aAAqC;IAErC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC;IACtE,OAAO,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE;QAC5C,KAAK;QACL,MAAM,EAAE,GAAG,CAAC,YAAY,CAAC,OAAO;QAChC,MAAM;KACP,CAAC,CAAC;AACL,CAAC"}

package/dist/mocks/mock-service.d.ts

@@ -0,0 +1,23 @@
+import { type ServiceAdapter, type ServiceResponse } from '@sensigo/realm';
+/** A single recorded call to the mock adapter. */
+export interface RecordedCall {
+    method: 'fetch' | 'create' | 'update';
+    operation: string;
+    params: Record<string, unknown>;
+}
+/**
+ * MockServiceRecorder implements ServiceAdapter. Returns pre-configured responses
+ * and records all calls for post-test assertions.
+ */
+export declare class MockServiceRecorder implements ServiceAdapter {
+    readonly id: string;
+    private readonly responses;
+    /** Ordered list of all calls made to this adapter. */
+    readonly calls: RecordedCall[];
+    constructor(id: string, responses: Record<string, ServiceResponse>);
+    fetch(operation: string, params: Record<string, unknown>, _config: Record<string, unknown>, _signal?: AbortSignal): Promise<ServiceResponse>;
+    create(operation: string, params: Record<string, unknown>, _config: Record<string, unknown>, _signal?: AbortSignal): Promise<ServiceResponse>;
+    update(operation: string, params: Record<string, unknown>, _config: Record<string, unknown>, _signal?: AbortSignal): Promise<ServiceResponse>;
+    private lookupResponse;
+}
+//# sourceMappingURL=mock-service.d.ts.map

package/dist/mocks/mock-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-service.d.ts","sourceRoot":"","sources":["../../src/mocks/mock-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE1F,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,cAAc;aAKtC,EAAE,EAAE,MAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL5B,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,CAAM;gBAGlB,EAAE,EAAE,MAAM,EACT,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;IAGvD,KAAK,CACT,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,eAAe,CAAC;IAKrB,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,eAAe,CAAC;IAKrB,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,eAAe,CAAC;IAK3B,OAAO,CAAC,cAAc;CAevB"}

package/dist/mocks/mock-service.js

@@ -0,0 +1,41 @@
+// MockServiceRecorder — records all calls and returns pre-configured responses.
+import { WorkflowError } from '@sensigo/realm';
+/**
+ * MockServiceRecorder implements ServiceAdapter. Returns pre-configured responses
+ * and records all calls for post-test assertions.
+ */
+export class MockServiceRecorder {
+    id;
+    responses;
+    /** Ordered list of all calls made to this adapter. */
+    calls = [];
+    constructor(id, responses) {
+        this.id = id;
+        this.responses = responses;
+    }
+    async fetch(operation, params, _config, _signal) {
+        this.calls.push({ method: 'fetch', operation, params });
+        return this.lookupResponse(operation);
+    }
+    async create(operation, params, _config, _signal) {
+        this.calls.push({ method: 'create', operation, params });
+        return this.lookupResponse(operation);
+    }
+    async update(operation, params, _config, _signal) {
+        this.calls.push({ method: 'update', operation, params });
+        return this.lookupResponse(operation);
+    }
+    lookupResponse(operation) {
+        const response = this.responses[operation];
+        if (response === undefined) {
+            throw new WorkflowError(`MockServiceRecorder: no response configured for operation '${operation}'`, {
+                code: 'ENGINE_ADAPTER_FAILED',
+                category: 'ENGINE',
+                agentAction: 'report_to_user',
+                retryable: false,
+            });
+        }
+        return response;
+    }
+}
+//# sourceMappingURL=mock-service.js.map

package/dist/mocks/mock-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-service.js","sourceRoot":"","sources":["../../src/mocks/mock-service.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,EAAE,aAAa,EAA6C,MAAM,gBAAgB,CAAC;AAS1F;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IAKZ;IACC;IALnB,sDAAsD;IAC7C,KAAK,GAAmB,EAAE,CAAC;IAEpC,YACkB,EAAU,EACT,SAA0C;QAD3C,OAAE,GAAF,EAAE,CAAQ;QACT,cAAS,GAAT,SAAS,CAAiC;IAC1D,CAAC;IAEJ,KAAK,CAAC,KAAK,CACT,SAAiB,EACjB,MAA+B,EAC/B,OAAgC,EAChC,OAAqB;QAErB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,MAAM,CACV,SAAiB,EACjB,MAA+B,EAC/B,OAAgC,EAChC,OAAqB;QAErB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,MAAM,CACV,SAAiB,EACjB,MAA+B,EAC/B,OAAgC,EAChC,OAAqB;QAErB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAEO,cAAc,CAAC,SAAiB;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,aAAa,CACrB,8DAA8D,SAAS,GAAG,EAC1E;gBACE,IAAI,EAAE,uBAAuB;gBAC7B,QAAQ,EAAE,QAAQ;gBAClB,WAAW,EAAE,gBAAgB;gBAC7B,SAAS,EAAE,KAAK;aACjB,CACF,CAAC;QACJ,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/runner/test-runner.d.ts

@@ -0,0 +1,29 @@
+import { ExtensionRegistry } from '@sensigo/realm';
+/** Result of a single fixture test run. */
+export interface TestResult {
+    /** Fixture name. */
+    name: string;
+    passed: boolean;
+    /** Error message if passed === false. */
+    error?: string;
+}
+/** Options for runFixtureTests. */
+export interface RunFixtureTestsOptions {
+    /** Path to workflow.yaml or to the directory containing workflow.yaml. */
+    workflowPath: string;
+    /** Path to a directory containing *.yaml fixture files. */
+    fixturesPath: string;
+    /**
+     * Optional ExtensionRegistry. If provided, handlers and adapters registered
+     * here are available as a fallback in the dispatcher. If omitted, a new empty
+     * registry is created per fixture run.
+     */
+    registry?: ExtensionRegistry;
+}
+/**
+ * Runs all fixture tests for the workflow.
+ * Returns TestResult[] (one per fixture).
+ */
+export declare function runFixtureTests(options: RunFixtureTestsOptions): Promise<TestResult[]>;
+/** Result of a single fixture test run. */
+//# sourceMappingURL=test-runner.d.ts.map

package/dist/runner/test-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-runner.d.ts","sourceRoot":"","sources":["../../src/runner/test-runner.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,iBAAiB,EAKlB,MAAM,gBAAgB,CAAC;AAUxB,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACzB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,mCAAmC;AACnC,MAAM,WAAW,sBAAsB;IACrC,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AA+KD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAY5F;AAED,2CAA2C"}

package/dist/runner/test-runner.js

@@ -0,0 +1,161 @@
+// Test runner — drives a workflow to completion per fixture and reports results.
+import { loadWorkflowFromFile, findEligibleSteps, createDefaultRegistry, executeChain, propagateSkips, } from '@sensigo/realm';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { InMemoryStore } from '../store/in-memory-store.js';
+import { loadFixturesFromDir } from '../fixtures/fixture-loader.js';
+import { MockServiceRecorder } from '../mocks/mock-service.js';
+import { createAgentDispatcher } from '../mocks/mock-agent.js';
+import { createGateResponder } from '../mocks/mock-gate.js';
+import { assertFinalState } from '../assertions/evidence.js';
+async function runSingleFixture(fixture, definition, options) {
+    try {
+        const store = new InMemoryStore();
+        // Build per-fixture registry: start from built-in adapters, then overlay
+        // mock adapters so fixture mocks take precedence over the real ones.
+        const fixtureRegistry = createDefaultRegistry();
+        for (const [serviceName, mockOps] of Object.entries(fixture.mocks)) {
+            const serviceDef = definition.services?.[serviceName];
+            if (serviceDef !== undefined) {
+                const recorder = new MockServiceRecorder(serviceDef.adapter, mockOps);
+                fixtureRegistry.register('adapter', serviceDef.adapter, recorder);
+            }
+        }
+        const dispatcher = createAgentDispatcher(definition, fixtureRegistry, fixture.agent_responses, options.registry, fixture.agent_errors);
+        const run = await store.create({
+            workflowId: definition.id,
+            workflowVersion: definition.version,
+            params: fixture.params,
+        });
+        const runId = run.id;
+        const maxIterations = Object.keys(definition.steps).length * 2 + 10;
+        let iterations = 0;
+        let currentRun = run;
+        // Tracks how many times each step has been resumed after a mock error.
+        const stepResumeCount = {};
+        while (!currentRun.terminal_state) {
+            if (iterations++ >= maxIterations) {
+                return {
+                    name: fixture.name,
+                    passed: false,
+                    error: 'Workflow stalled: exceeded maximum loop iterations',
+                };
+            }
+            const eligibleSteps = findEligibleSteps(definition, currentRun);
+            if (eligibleSteps.length === 0 && currentRun.pending_gate === undefined) {
+                return {
+                    name: fixture.name,
+                    passed: false,
+                    error: `Workflow stalled: no eligible steps in phase '${currentRun.run_phase}'`,
+                };
+            }
+            // If a gate is open, respond to it and continue.
+            if (currentRun.pending_gate !== undefined) {
+                const gateResult = await createGateResponder(store, definition, runId, fixture.gate_responses ?? {});
+                if (gateResult.status === 'error') {
+                    return {
+                        name: fixture.name,
+                        passed: false,
+                        error: gateResult.errors[0] ?? 'Unknown gate response error',
+                    };
+                }
+                currentRun = await store.get(runId);
+                continue;
+            }
+            const nextStep = eligibleSteps[0];
+            const stepDef = definition.steps[nextStep];
+            // Agent steps need the fixture's pre-built response as the input so the
+            // engine's input_schema validation passes before the dispatcher runs.
+            // Auto steps take no caller-provided input — the engine resolves it via
+            // input_map or the adapter/handler call.
+            const stepInput = stepDef?.execution === 'agent'
+                ? (fixture.agent_responses[nextStep] ?? {})
+                : {};
+            const envelope = await executeChain(store, definition, {
+                runId,
+                command: nextStep,
+                input: stepInput,
+                dispatcher,
+                registry: fixtureRegistry,
+            });
+            if (envelope.status === 'error') {
+                // If this step has mock errors configured and we haven't exhausted them yet,
+                // simulate `realm run resume --from <step>`: remove the step from failed_steps
+                // to make it eligible again, then continue the loop.
+                const mockErrors = fixture.agent_errors?.[nextStep];
+                const resumesDone = stepResumeCount[nextStep] ?? 0;
+                if (mockErrors !== undefined && resumesDone < mockErrors.length) {
+                    stepResumeCount[nextStep] = resumesDone + 1;
+                    const failedRun = await store.get(runId);
+                    const { terminal_reason: _tr, ...rest } = failedRun;
+                    const newFailedSteps = rest.failed_steps.filter((s) => s !== nextStep);
+                    // Recompute skipped_steps: the old skips were derived with nextStep in
+                    // failed_steps. Re-derive from scratch so steps that were only skipped
+                    // because of this failure become eligible again on the retry.
+                    const tempRun = { ...rest, failed_steps: newFailedSteps, skipped_steps: [] };
+                    const newSkippedSteps = propagateSkips(tempRun, definition);
+                    await store.update({
+                        ...rest,
+                        failed_steps: newFailedSteps,
+                        skipped_steps: newSkippedSteps,
+                        terminal_state: false,
+                    });
+                    currentRun = await store.get(runId);
+                    continue;
+                }
+                return {
+                    name: fixture.name,
+                    passed: false,
+                    error: envelope.errors[0] ?? 'Unknown error from step execution',
+                };
+            }
+            currentRun = await store.get(runId);
+        }
+        // Assert final phase.
+        assertFinalState(currentRun, fixture.expected.final_state);
+        // Assert skipped_steps when declared — exact set equality.
+        if (fixture.expected.skipped_steps !== undefined) {
+            const actualSkipped = [...currentRun.skipped_steps].sort();
+            const expectedSkipped = [...fixture.expected.skipped_steps].sort();
+            if (JSON.stringify(actualSkipped) !== JSON.stringify(expectedSkipped)) {
+                throw new Error(`Expected skipped_steps ${JSON.stringify(expectedSkipped)} but got ${JSON.stringify(actualSkipped)}`);
+            }
+        }
+        // Assert expected evidence entries if provided.
+        if (fixture.expected.evidence !== undefined) {
+            for (const expected of fixture.expected.evidence) {
+                const snap = currentRun.evidence.find((e) => e.step_id === expected.step_id &&
+                    e.kind !== 'gate_response' &&
+                    (expected.status === undefined || e.status === expected.status));
+                if (snap === undefined) {
+                    const statusClause = expected.status !== undefined ? ` with status '${expected.status}'` : '';
+                    throw new Error(`Expected evidence for step '${expected.step_id}'${statusClause} not found`);
+                }
+            }
+        }
+        return { name: fixture.name, passed: true };
+    }
+    catch (err) {
+        return {
+            name: fixture.name,
+            passed: false,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+/**
+ * Runs all fixture tests for the workflow.
+ * Returns TestResult[] (one per fixture).
+ */
+export async function runFixtureTests(options) {
+    const workflowFilePath = options.workflowPath.endsWith('.yaml') || options.workflowPath.endsWith('.yml')
+        ? options.workflowPath
+        : existsSync(join(options.workflowPath, 'workflow.yaml'))
+            ? join(options.workflowPath, 'workflow.yaml')
+            : options.workflowPath;
+    const definition = loadWorkflowFromFile(workflowFilePath);
+    const fixtures = loadFixturesFromDir(options.fixturesPath);
+    return Promise.all(fixtures.map((fixture) => runSingleFixture(fixture, definition, options)));
+}
+/** Result of a single fixture test run. */
+//# sourceMappingURL=test-runner.js.map

package/dist/runner/test-runner.js.map

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

package/dist/servers/github-mock-server.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Handle for a running GitHubMockServer instance.
+ * Call `close()` in afterAll to release the port.
+ */
+export interface GitHubMockServerHandle {
+    /** Base URL of the server, e.g. "http://localhost:3032". */
+    url: string;
+    /** Closes the server and resolves when fully shut down. */
+    close(): Promise<void>;
+}
+/**
+ * Starts a local HTTP server that serves responses from a JSON fixture file.
+ * Reads the fixture once at startup; does not re-read on each request.
+ *
+ * @param fixturePath - Absolute path to the fixture JSON file.
+ * @param port - Port to bind to (default 3032).
+ * @returns A handle with the server URL and a `close()` method.
+ */
+export declare function startGitHubMockServer(fixturePath: string, port?: number): Promise<GitHubMockServerHandle>;
+//# sourceMappingURL=github-mock-server.d.ts.map

package/dist/servers/github-mock-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-mock-server.d.ts","sourceRoot":"","sources":["../../src/servers/github-mock-server.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAiCD;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,IAAI,SAAO,GACV,OAAO,CAAC,sBAAsB,CAAC,CAqEjC"}

package/dist/servers/github-mock-server.js

@@ -0,0 +1,107 @@
+// GitHubMockServer — local HTTP server that replays fixture-defined GitHub API responses.
+import * as http from 'node:http';
+import * as fs from 'node:fs';
+/**
+ * Matches a request method + URL path against a fixture key like "GET /repos/:owner/:repo/pulls/:pr".
+ * `:param` segments match any non-empty, non-slash string.
+ */
+function matchRoute(method, urlPath, fixtureKey) {
+    const spaceIdx = fixtureKey.indexOf(' ');
+    if (spaceIdx === -1)
+        return false;
+    const fixtureMethod = fixtureKey.slice(0, spaceIdx);
+    const fixturePath = fixtureKey.slice(spaceIdx + 1);
+    if (method !== fixtureMethod)
+        return false;
+    const urlSegments = urlPath.split('/');
+    const fixtureSegments = fixturePath.split('/');
+    if (urlSegments.length !== fixtureSegments.length)
+        return false;
+    for (let i = 0; i < fixtureSegments.length; i++) {
+        const fSeg = fixtureSegments[i];
+        const uSeg = urlSegments[i];
+        if (fSeg === undefined || uSeg === undefined)
+            return false;
+        if (fSeg.startsWith(':')) {
+            if (uSeg.length === 0)
+                return false;
+        }
+        else if (fSeg !== uSeg) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Starts a local HTTP server that serves responses from a JSON fixture file.
+ * Reads the fixture once at startup; does not re-read on each request.
+ *
+ * @param fixturePath - Absolute path to the fixture JSON file.
+ * @param port - Port to bind to (default 3032).
+ * @returns A handle with the server URL and a `close()` method.
+ */
+export async function startGitHubMockServer(fixturePath, port = 3032) {
+    const raw = fs.readFileSync(fixturePath, 'utf-8');
+    const fixture = JSON.parse(raw);
+    const server = http.createServer((req, res) => {
+        const method = req.method ?? 'GET';
+        const rawUrl = req.url ?? '/';
+        const urlPath = rawUrl.split('?')[0] ?? '/';
+        let matchedKey;
+        for (const key of Object.keys(fixture)) {
+            if (matchRoute(method, urlPath, key)) {
+                matchedKey = key;
+                break;
+            }
+        }
+        if (matchedKey === undefined) {
+            res.writeHead(404, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'no matching fixture route' }));
+            return;
+        }
+        const entry = fixture[matchedKey];
+        if ('echo' in entry) {
+            const chunks = [];
+            req.on('data', (chunk) => chunks.push(chunk));
+            req.on('end', () => {
+                try {
+                    const body = JSON.parse(Buffer.concat(chunks).toString('utf-8'));
+                    const responseBody = {};
+                    for (const field of entry.echo) {
+                        responseBody[field] = body[field];
+                    }
+                    res.writeHead(entry.status, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify(responseBody));
+                }
+                catch {
+                    res.writeHead(400, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'invalid JSON body' }));
+                }
+            });
+        }
+        else {
+            res.writeHead(entry.status, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify(entry.body));
+        }
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', (err) => {
+            reject(new Error(`GitHubMockServer: cannot bind to port ${port}: ${err.message}`));
+        });
+        server.listen(port, '127.0.0.1', () => resolve());
+    });
+    return {
+        url: `http://localhost:${port}`,
+        close() {
+            return new Promise((resolve, reject) => {
+                server.close((err) => {
+                    if (err !== undefined)
+                        reject(err);
+                    else
+                        resolve();
+                });
+            });
+        },
+    };
+}
+//# sourceMappingURL=github-mock-server.js.map

package/dist/servers/github-mock-server.js.map

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

package/dist/store/in-memory-store.d.ts

@@ -0,0 +1,11 @@
+import { type RunStore, type RunRecord, type CreateRunOptions, type WorkflowDefinition } from '@sensigo/realm';
+/** In-memory implementation of RunStore. Uses a Map keyed by run ID. No I/O, no locking. */
+export declare class InMemoryStore implements RunStore {
+    private readonly runs;
+    create(options: CreateRunOptions): Promise<RunRecord>;
+    get(runId: string): Promise<RunRecord>;
+    update(record: RunRecord): Promise<RunRecord>;
+    claimStep(runId: string, stepName: string, definition: WorkflowDefinition): Promise<RunRecord>;
+    list(workflowId?: string): Promise<RunRecord[]>;
+}
+//# sourceMappingURL=in-memory-store.d.ts.map

package/dist/store/in-memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-store.d.ts","sourceRoot":"","sources":["../../src/store/in-memory-store.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAExB,4FAA4F;AAC5F,qBAAa,aAAc,YAAW,QAAQ;IAC5C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgC;IAE/C,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC;IAsBrD,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAatC,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IA6B7C,SAAS,CACb,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,kBAAkB,GAC7B,OAAO,CAAC,SAAS,CAAC;IAoCf,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAOtD"}

package/dist/store/in-memory-store.js

@@ -0,0 +1,110 @@
+// InMemoryStore — in-memory implementation of RunStore for use in tests.
+import { WorkflowError, findEligibleSteps, deriveRunPhase, } from '@sensigo/realm';
+/** In-memory implementation of RunStore. Uses a Map keyed by run ID. No I/O, no locking. */
+export class InMemoryStore {
+    runs = new Map();
+    async create(options) {
+        const now = new Date().toISOString();
+        const record = {
+            id: crypto.randomUUID(),
+            workflow_id: options.workflowId,
+            workflow_version: options.workflowVersion,
+            completed_steps: [],
+            in_progress_steps: [],
+            failed_steps: [],
+            skipped_steps: [],
+            run_phase: 'running',
+            version: 0,
+            params: options.params,
+            evidence: [],
+            created_at: now,
+            updated_at: now,
+            terminal_state: false,
+        };
+        this.runs.set(record.id, record);
+        return record;
+    }
+    async get(runId) {
+        const record = this.runs.get(runId);
+        if (record === undefined) {
+            throw new WorkflowError(`Run '${runId}' not found`, {
+                code: 'STATE_RUN_NOT_FOUND',
+                category: 'STATE',
+                agentAction: 'report_to_user',
+                retryable: false,
+            });
+        }
+        return record;
+    }
+    async update(record) {
+        const existing = this.runs.get(record.id);
+        if (existing === undefined) {
+            throw new WorkflowError(`Run '${record.id}' not found`, {
+                code: 'STATE_RUN_NOT_FOUND',
+                category: 'STATE',
+                agentAction: 'report_to_user',
+                retryable: false,
+            });
+        }
+        if (existing.version !== record.version) {
+            throw new WorkflowError('Version conflict — run was modified by another process', {
+                code: 'STATE_SNAPSHOT_MISMATCH',
+                category: 'STATE',
+                agentAction: 'report_to_user',
+                retryable: true,
+                details: { runId: record.id, expected: record.version, actual: existing.version },
+            });
+        }
+        const updated = {
+            ...record,
+            run_phase: deriveRunPhase(record),
+            version: record.version + 1,
+            updated_at: new Date().toISOString(),
+        };
+        this.runs.set(updated.id, updated);
+        return updated;
+    }
+    async claimStep(runId, stepName, definition) {
+        const run = await this.get(runId);
+        const alreadyDone = [
+            ...run.completed_steps,
+            ...run.in_progress_steps,
+            ...run.failed_steps,
+            ...run.skipped_steps,
+        ];
+        if (alreadyDone.includes(stepName)) {
+            throw new WorkflowError(`Step '${stepName}' is already claimed or done`, {
+                code: 'STATE_STEP_ALREADY_CLAIMED',
+                category: 'STATE',
+                agentAction: 'resolve_precondition',
+                retryable: false,
+            });
+        }
+        const eligible = findEligibleSteps(definition, run);
+        if (!eligible.includes(stepName)) {
+            throw new WorkflowError(`Step '${stepName}' is not eligible`, {
+                code: 'STATE_STEP_NOT_ELIGIBLE',
+                category: 'STATE',
+                agentAction: 'resolve_precondition',
+                retryable: false,
+            });
+        }
+        const updated = {
+            ...run,
+            in_progress_steps: [...run.in_progress_steps, stepName],
+            run_phase: 'running',
+            version: run.version + 1,
+            updated_at: new Date().toISOString(),
+        };
+        this.runs.set(updated.id, updated);
+        return updated;
+    }
+    async list(workflowId) {
+        const all = [...this.runs.values()];
+        if (workflowId !== undefined) {
+            return all.filter((r) => r.workflow_id === workflowId);
+        }
+        return all;
+    }
+}
+//# sourceMappingURL=in-memory-store.js.map

package/dist/store/in-memory-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-store.js","sourceRoot":"","sources":["../../src/store/in-memory-store.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,cAAc,GAKf,MAAM,gBAAgB,CAAC;AAExB,4FAA4F;AAC5F,MAAM,OAAO,aAAa;IACP,IAAI,GAAG,IAAI,GAAG,EAAqB,CAAC;IAErD,KAAK,CAAC,MAAM,CAAC,OAAyB;QACpC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,MAAM,GAAc;YACxB,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;YACvB,WAAW,EAAE,OAAO,CAAC,UAAU;YAC/B,gBAAgB,EAAE,OAAO,CAAC,eAAe;YACzC,eAAe,EAAE,EAAE;YACnB,iBAAiB,EAAE,EAAE;YACrB,YAAY,EAAE,EAAE;YAChB,aAAa,EAAE,EAAE;YACjB,SAAS,EAAE,SAAS;YACpB,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,GAAG;YACf,UAAU,EAAE,GAAG;YACf,cAAc,EAAE,KAAK;SACtB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACjC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAAa;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,aAAa,CAAC,QAAQ,KAAK,aAAa,EAAE;gBAClD,IAAI,EAAE,qBAAqB;gBAC3B,QAAQ,EAAE,OAAO;gBACjB,WAAW,EAAE,gBAAgB;gBAC7B,SAAS,EAAE,KAAK;aACjB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAiB;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC1C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,aAAa,CAAC,QAAQ,MAAM,CAAC,EAAE,aAAa,EAAE;gBACtD,IAAI,EAAE,qBAAqB;gBAC3B,QAAQ,EAAE,OAAO;gBACjB,WAAW,EAAE,gBAAgB;gBAC7B,SAAS,EAAE,KAAK;aACjB,CAAC,CAAC;QACL,CAAC;QACD,IAAI,QAAQ,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC;YACxC,MAAM,IAAI,aAAa,CAAC,wDAAwD,EAAE;gBAChF,IAAI,EAAE,yBAAyB;gBAC/B,QAAQ,EAAE,OAAO;gBACjB,WAAW,EAAE,gBAAgB;gBAC7B,SAAS,EAAE,IAAI;gBACf,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE;aAClF,CAAC,CAAC;QACL,CAAC;QACD,MAAM,OAAO,GAAc;YACzB,GAAG,MAAM;YACT,SAAS,EAAE,cAAc,CAAC,MAAM,CAAC;YACjC,OAAO,EAAE,MAAM,CAAC,OAAO,GAAG,CAAC;YAC3B,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACnC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,SAAS,CACb,KAAa,EACb,QAAgB,EAChB,UAA8B;QAE9B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,WAAW,GAAG;YAClB,GAAG,GAAG,CAAC,eAAe;YACtB,GAAG,GAAG,CAAC,iBAAiB;YACxB,GAAG,GAAG,CAAC,YAAY;YACnB,GAAG,GAAG,CAAC,aAAa;SACrB,CAAC;QACF,IAAI,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,aAAa,CAAC,SAAS,QAAQ,8BAA8B,EAAE;gBACvE,IAAI,EAAE,4BAA4B;gBAClC,QAAQ,EAAE,OAAO;gBACjB,WAAW,EAAE,sBAAsB;gBACnC,SAAS,EAAE,KAAK;aACjB,CAAC,CAAC;QACL,CAAC;QACD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,aAAa,CAAC,SAAS,QAAQ,mBAAmB,EAAE;gBAC5D,IAAI,EAAE,yBAAyB;gBAC/B,QAAQ,EAAE,OAAO;gBACjB,WAAW,EAAE,sBAAsB;gBACnC,SAAS,EAAE,KAAK;aACjB,CAAC,CAAC;QACL,CAAC;QACD,MAAM,OAAO,GAAc;YACzB,GAAG,GAAG;YACN,iBAAiB,EAAE,CAAC,GAAG,GAAG,CAAC,iBAAiB,EAAE,QAAQ,CAAC;YACvD,SAAS,EAAE,SAAS;YACpB,OAAO,EAAE,GAAG,CAAC,OAAO,GAAG,CAAC;YACxB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACnC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAmB;QAC5B,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACpC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,UAAU,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}