@flowrensic/node 0.1.2 → 0.2.0

package/README.md

@@ -3,35 +3,58 @@
 Replay the histories your workflows already produced, against the code you are
 about to ship.
 
-Flowrensic keeps what a Temporal server recorded. This package fetches a set and
-replays it through Temporal's own replayer, in your tests, against your
-checkout. Histories in a repo go stale on the next deploy and nobody can say
-which are still safe to delete.
+Flowrensic keeps what a Temporal server recorded. This package fetches a set to
+disk and reports back what your replay found. The replay itself stays yours:
+call Temporal's replayer directly, in your suite, with your own bundler options.
+Histories in a repo go stale on the next deploy and nobody can say which are
+still safe to delete.
 
 Server: `flowrensic/flowrensic` on Docker Hub. Temporal is the supported engine.
 
 ## Replay
 
-    docker run --rm -v "$PWD/replay-set:/out" --entrypoint /flowrensic \
-      flowrensic/flowrensic replay fetch \
-      --server http://flowrensic:8080 --workflow-type OrderWorkflow --out /out
-
 ```ts
-import { replayFetchedSet } from '@flowrensic/node';
+import { fetchReplaySet, publishVerdicts, readReplaySet } from '@flowrensic/node';
+import { historyFromJSON } from '@temporalio/common/lib/proto-utils.js';
+import { Worker } from '@temporalio/worker';
 
-const report = await replayFetchedSet({
-  dir: 'replay-set',
-  workflowsPath: require.resolve('./workflows'),
-  codeVersion: process.env.GIT_SHA,
+await fetchReplaySet({
   baseUrl: 'http://flowrensic:8080',
+  workflowType: 'OrderWorkflow',
+  dir: 'replay-set',
 });
 
-if (report.failed > 0) throw new Error(`${report.failed} histories no longer replay`);
+const set = await readReplaySet('replay-set');
+const histories = await Promise.all(
+  set.histories.map(async (entry) => ({
+    workflowId: entry.run_id,
+    history: historyFromJSON(JSON.parse(await readFile(join('replay-set', entry.file), 'utf8'))),
+  })),
+);
+
+const verdicts = [];
+for await (const result of Worker.runReplayHistories({ workflowsPath }, histories)) {
+  verdicts.push({
+    runId: result.workflowId,
+    workflowType: set.workflow_type,
+    passed: result.error === undefined,
+    error: result.error?.message,
+  });
+}
+
+await publishVerdicts({
+  baseUrl: 'http://flowrensic:8080',
+  codeVersion: process.env.GIT_SHA,
+  verdicts,
+});
 ```
 
 Verdicts go back against the run and the version, so a break points at the
 change that caused it.
 
+`flowrensic replay fetch` in the CLI writes the same directory and the same
+manifest, for a pipeline that would rather fetch in a step than in a test.
+
 The server picks the set: recent histories, versions still running somewhere,
 outcomes that differ. Newest-ten on a healthy workflow type is ten completions
 and not one failure.
@@ -59,4 +82,5 @@ never fail the activity it measures.
 ## Peers
 
 `@temporalio/worker`, `@temporalio/common`, `@temporalio/activity`, 1.24 or
-newer. The replay has to run on the same SDK your workers do.
+newer, for the interceptor. The replay runs on your SDK, not on one this
+package pins.

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { createAttemptSink, type AttemptSink, type SinkOptions } from './sink.js';
 export { FlowrensicActivityInterceptor, flowrensicInterceptor } from './interceptor.js';
 export { createFlowrensicClient, type FlowrensicClient } from './client.js';
-export { replayFetchedSet, readReplaySet, listHistoryFiles, INDEX_NAME, type ReplayOptions, type ReplayReport, type ReplayVerdict, type ReplaySet, type ReplaySetEntry, } from './replay.js';
+export { fetchReplaySet, readReplaySet, listHistoryFiles, publishVerdicts, INDEX_NAME, type FetchOptions, type PublishOptions, type ReplayVerdict, type ReplaySet, type ReplaySetEntry, } from './replay.js';
 export type { ActivityAttempt, ActivityStats, } from './gen/flowrensic/v1/activity_metrics_pb.js';
 export { Outcome } from './gen/flowrensic/v1/activity_metrics_pb.js';
 export type { EngineMetric } from './gen/flowrensic/v1/activity_metrics_pb.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAClF,OAAO,EAAE,6BAA6B,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACxF,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,eAAe,EACf,aAAa,GACd,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,4CAA4C,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC/E,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AACtF,YAAY,EAAE,OAAO,EAAE,MAAM,4CAA4C,CAAC;AAC1E,YAAY,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAClF,OAAO,EAAE,6BAA6B,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACxF,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EACL,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,eAAe,EACf,aAAa,GACd,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,4CAA4C,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC/E,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AACtF,YAAY,EAAE,OAAO,EAAE,MAAM,4CAA4C,CAAC;AAC1E,YAAY,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 export { createAttemptSink } from './sink.js';
 export { FlowrensicActivityInterceptor, flowrensicInterceptor } from './interceptor.js';
 export { createFlowrensicClient } from './client.js';
-export { replayFetchedSet, readReplaySet, listHistoryFiles, INDEX_NAME, } from './replay.js';
+export { fetchReplaySet, readReplaySet, listHistoryFiles, publishVerdicts, INDEX_NAME, } from './replay.js';
 export { Outcome } from './gen/flowrensic/v1/activity_metrics_pb.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAsC,MAAM,WAAW,CAAC;AAClF,OAAO,EAAE,6BAA6B,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACxF,OAAO,EAAE,sBAAsB,EAAyB,MAAM,aAAa,CAAC;AAC5E,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,UAAU,GAMX,MAAM,aAAa,CAAC;AAMrB,OAAO,EAAE,OAAO,EAAE,MAAM,4CAA4C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAsC,MAAM,WAAW,CAAC;AAClF,OAAO,EAAE,6BAA6B,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACxF,OAAO,EAAE,sBAAsB,EAAyB,MAAM,aAAa,CAAC;AAC5E,OAAO,EACL,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,UAAU,GAMX,MAAM,aAAa,CAAC;AAMrB,OAAO,EAAE,OAAO,EAAE,MAAM,4CAA4C,CAAC"}

package/dist/replay.d.ts

@@ -1,6 +1,6 @@
-/** Manifest the CLI writes beside the histories it fetched. */
+/** Manifest written beside the histories, the same one the CLI writes. */
 export declare const INDEX_NAME = "replay-set.json";
-/** One history on disk, as `flowrensic replay fetch` recorded it. */
+/** One history on disk, with the metadata the server chose it by. */
 export interface ReplaySetEntry {
     readonly run_id: string;
     readonly file: string;
@@ -17,6 +17,18 @@ export interface ReplaySet {
     readonly server: string;
     readonly histories: readonly ReplaySetEntry[];
 }
+export interface FetchOptions {
+    /** Flowrensic base URL, e.g. `http://flowrensic:8080`. */
+    baseUrl: string;
+    /** A set spans one workflow type, because that is what a replayer is built for. */
+    workflowType: string;
+    /** Directory to write the histories and the manifest into. */
+    dir: string;
+    /** Left out, the set spans every environment. */
+    deployEnv?: string;
+    /** Left out, the server picks how many. */
+    limit?: number;
+}
 /** What one history did when replayed against the checkout under test. */
 export interface ReplayVerdict {
     readonly runId: string;
@@ -25,39 +37,33 @@ export interface ReplayVerdict {
     /** The replayer's own message, kept verbatim: it names what diverged. */
     readonly error?: string;
 }
-export interface ReplayReport {
-    readonly total: number;
-    readonly failed: number;
-    readonly verdicts: readonly ReplayVerdict[];
-}
-export interface ReplayOptions {
-    /** Directory `flowrensic replay fetch --out` wrote. */
-    dir: string;
-    /** The checkout's workflows, the same path a worker would be given. */
-    workflowsPath: string;
+export interface PublishOptions {
+    baseUrl: string;
     /**
-     * The commit, tag or build under test. Only the pipeline knows it, and a
+     * The commit, tag or build replayed. Only the pipeline knows it, and a
      * verdict without one cannot be attributed to a change.
      */
     codeVersion: string;
-    /**
-     * Flowrensic server to report to. Left out, the replay still runs and the
-     * report is returned but published nowhere.
-     */
-    baseUrl?: string;
-    /** Extra worker options, for a project that needs its own data converter. */
-    bundlerOptions?: Record<string, unknown>;
+    verdicts: readonly ReplayVerdict[];
 }
-export declare function readReplaySet(dir: string): Promise<ReplaySet>;
 /**
- * Replays every history in a fetched set against the workflows in this
- * checkout, and reports the verdicts.
+ * Fetches the set the server picks for a workflow type and writes it to disk.
+ *
+ * Which histories are worth replaying is the server's call, not the caller's.
+ * What comes down is the engine's own history, verbatim, so a replayer reads
+ * it the way the engine wrote it.
  *
- * The replay happens here, in the customer's own SDK, because that is the only
- * place the workflow code and its bundler exist. Flowrensic supplies the
- * histories and takes back what happened.
+ * Nothing here runs a workflow. Replay belongs to the suite that owns the
+ * code, through its own SDK, and `publishVerdicts` takes the outcome back.
  */
-export declare function replayFetchedSet(options: ReplayOptions): Promise<ReplayReport>;
+export declare function fetchReplaySet(options: FetchOptions): Promise<ReplaySet>;
+/** Reads a manifest a fetch left behind, the CLI's or this package's. */
+export declare function readReplaySet(dir: string): Promise<ReplaySet>;
 /** Histories in a directory, for a caller that wants them without the index. */
 export declare function listHistoryFiles(dir: string): Promise<string[]>;
+/**
+ * Reports what a replay found, against the history and the version replayed,
+ * so a break is attributed to a code change rather than to a failing test.
+ */
+export declare function publishVerdicts(options: PublishOptions): Promise<void>;
 //# sourceMappingURL=replay.d.ts.map

package/dist/replay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../src/replay.ts"],"names":[],"mappings":"AAUA,+DAA+D;AAC/D,eAAO,MAAM,UAAU,oBAAoB,CAAC;AAE5C,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;CAC/C;AAED,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,uEAAuE;IACvE,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAQD,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAOnE;AA+BD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAoCpF;AAED,gFAAgF;AAChF,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGrE"}
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../src/replay.ts"],"names":[],"mappings":"AAQA,0EAA0E;AAC1E,eAAO,MAAM,UAAU,oBAAoB,CAAC;AAE5C,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,YAAY,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;CACpC;AAqBD;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAmD9E;AAQD,yEAAyE;AACzE,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAOnE;AAED,gFAAgF;AAChF,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGrE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB5E"}

package/dist/replay.js

@@ -1,12 +1,81 @@
-import { readFile, readdir } from 'node:fs/promises';
+import { mkdir, readFile, readdir, rename, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
-// Node ESM needs the extension on a subpath of a package that declares no
-// `exports`, and `historyFromJSON` is not on the package's own entry point.
-import { historyFromJSON } from '@temporalio/common/lib/proto-utils.js';
-import { Worker } from '@temporalio/worker';
+import { timestampDate, timestampFromDate } from '@bufbuild/protobuf/wkt';
 import { createFlowrensicClient } from './client.js';
-/** Manifest the CLI writes beside the histories it fetched. */
+import { RunStatus } from './gen/flowrensic/v1/replay_pb.js';
+/** Manifest written beside the histories, the same one the CLI writes. */
 export const INDEX_NAME = 'replay-set.json';
+// A manifest reads `completed`, the same label the CLI writes. A table rather
+// than a reverse enum lookup, so adding a status is a compile error here.
+const STATUS_LABELS = {
+    [RunStatus.UNSPECIFIED]: 'unspecified',
+    [RunStatus.RUNNING]: 'running',
+    [RunStatus.COMPLETED]: 'completed',
+    [RunStatus.FAILED]: 'failed',
+    [RunStatus.CANCELED]: 'canceled',
+    [RunStatus.TERMINATED]: 'terminated',
+    [RunStatus.TIMED_OUT]: 'timed_out',
+    [RunStatus.CONTINUED_AS_NEW]: 'continued_as_new',
+    [RunStatus.PAUSED]: 'paused',
+};
+function historyUrl(baseUrl, path) {
+    const base = baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`;
+    return new URL(path.replace(/^\//, ''), base);
+}
+/**
+ * Fetches the set the server picks for a workflow type and writes it to disk.
+ *
+ * Which histories are worth replaying is the server's call, not the caller's.
+ * What comes down is the engine's own history, verbatim, so a replayer reads
+ * it the way the engine wrote it.
+ *
+ * Nothing here runs a workflow. Replay belongs to the suite that owns the
+ * code, through its own SDK, and `publishVerdicts` takes the outcome back.
+ */
+export async function fetchReplaySet(options) {
+    const { baseUrl, workflowType, dir, deployEnv, limit } = options;
+    const client = createFlowrensicClient(baseUrl);
+    const found = await client.query.listReplayHistories({
+        workflowType,
+        deployEnv: deployEnv ?? '',
+        limit: limit ?? 0,
+    });
+    // An empty set is not an error: a workflow type with no runs yet is a normal
+    // state on a new pipeline, and the caller decides what to do about it.
+    await mkdir(dir, { recursive: true, mode: 0o750 });
+    const histories = [];
+    for (const history of found.histories) {
+        const file = `${history.runId}.json`;
+        const response = await fetch(historyUrl(baseUrl, history.url));
+        if (!response.ok) {
+            const body = (await response.text()).slice(0, 512).trim();
+            throw new Error(`history ${history.runId}: status ${String(response.status)}: ${body}`);
+        }
+        // Written and renamed, so a failed fetch never leaves a half history for a
+        // replayer to read as a non-determinism report.
+        const temp = join(dir, `.fetch-${history.runId}`);
+        await writeFile(temp, Buffer.from(await response.arrayBuffer()), { mode: 0o600 });
+        await rename(temp, join(dir, file));
+        histories.push({
+            run_id: history.runId,
+            file,
+            status: STATUS_LABELS[history.status],
+            ...(history.deployEnv === '' ? {} : { deploy_env: history.deployEnv }),
+            events: history.events,
+            started_at: (history.startedAt ? timestampDate(history.startedAt) : new Date(0)).toISOString(),
+            ...(history.closedAt ? { closed_at: timestampDate(history.closedAt).toISOString() } : {}),
+        });
+    }
+    const set = {
+        workflow_type: workflowType,
+        ...(deployEnv === undefined || deployEnv === '' ? {} : { deploy_env: deployEnv }),
+        fetched_at: new Date().toISOString(),
+        server: baseUrl,
+        histories,
+    };
+    await writeFile(join(dir, INDEX_NAME), `${JSON.stringify(set, null, 2)}\n`, { mode: 0o600 });
+    return set;
+}
 function isReplaySet(value) {
     if (typeof value !== 'object' || value === null)
         return false;
@@ -14,6 +83,7 @@ function isReplaySet(value) {
         return false;
     return 'histories' in value && Array.isArray(value.histories);
 }
+/** Reads a manifest a fetch left behind, the CLI's or this package's. */
 export async function readReplaySet(dir) {
     const path = join(dir, INDEX_NAME);
     const parsed = JSON.parse(await readFile(path, 'utf8'));
@@ -22,17 +92,21 @@ export async function readReplaySet(dir) {
     }
     return parsed;
 }
-/** protobuf Timestamp, which connect-es takes as seconds plus nanos. */
-function timestampFrom(at) {
-    const ms = at.getTime();
-    return {
-        seconds: BigInt(Math.floor(ms / 1000)),
-        nanos: (ms % 1000) * 1_000_000,
-    };
+/** Histories in a directory, for a caller that wants them without the index. */
+export async function listHistoryFiles(dir) {
+    const names = await readdir(dir);
+    return names.filter((n) => n.endsWith('.json') && n !== INDEX_NAME).sort();
 }
-async function publishVerdicts(baseUrl, codeVersion, verdicts) {
+/**
+ * Reports what a replay found, against the history and the version replayed,
+ * so a break is attributed to a code change rather than to a failing test.
+ */
+export async function publishVerdicts(options) {
+    const { baseUrl, codeVersion, verdicts } = options;
+    if (verdicts.length === 0)
+        return;
     const client = createFlowrensicClient(baseUrl);
-    const replayedAt = new Date();
+    const replayedAt = timestampFromDate(new Date());
     await client.ingest.ingestReplayResults({
         results: verdicts.map((v) => ({
             runId: v.runId,
@@ -40,54 +114,8 @@ async function publishVerdicts(baseUrl, codeVersion, verdicts) {
             workflowType: v.workflowType,
             passed: v.passed,
             error: v.error ?? '',
-            replayedAt: timestampFrom(replayedAt),
+            replayedAt,
         })),
     });
 }
-/**
- * Replays every history in a fetched set against the workflows in this
- * checkout, and reports the verdicts.
- *
- * The replay happens here, in the customer's own SDK, because that is the only
- * place the workflow code and its bundler exist. Flowrensic supplies the
- * histories and takes back what happened.
- */
-export async function replayFetchedSet(options) {
-    const { dir, workflowsPath, codeVersion, baseUrl, bundlerOptions } = options;
-    const set = await readReplaySet(dir);
-    const verdicts = [];
-    for (const entry of set.histories) {
-        const parsed = JSON.parse(await readFile(join(dir, entry.file), 'utf8'));
-        const history = historyFromJSON(parsed);
-        try {
-            await Worker.runReplayHistory({ workflowsPath, ...bundlerOptions }, history, entry.run_id);
-            verdicts.push({ runId: entry.run_id, workflowType: set.workflow_type, passed: true });
-        }
-        catch (err) {
-            // Any throw is a failed replay. The replayer distinguishes determinism
-            // violations from other errors, but both mean this history no longer
-            // runs on this code, which is the thing CI needs told.
-            verdicts.push({
-                runId: entry.run_id,
-                workflowType: set.workflow_type,
-                passed: false,
-                error: err instanceof Error ? err.message : String(err),
-            });
-        }
-    }
-    const report = {
-        total: verdicts.length,
-        failed: verdicts.filter((v) => !v.passed).length,
-        verdicts,
-    };
-    if (baseUrl !== undefined && verdicts.length > 0) {
-        await publishVerdicts(baseUrl, codeVersion, verdicts);
-    }
-    return report;
-}
-/** Histories in a directory, for a caller that wants them without the index. */
-export async function listHistoryFiles(dir) {
-    const names = await readdir(dir);
-    return names.filter((n) => n.endsWith('.json') && n !== INDEX_NAME).sort();
-}
 //# sourceMappingURL=replay.js.map

package/dist/replay.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@flowrensic/node",
-  "version": "0.1.2",
-  "description": "Replay runner and activity interceptor for Temporal workers, for use with Flowrensic.",
+  "version": "0.2.0",
+  "description": "Replay history fetch and activity interceptor for Temporal workers, for use with Flowrensic.",
   "type": "module",
   "main": "./dist/index.js",
   "exports": {