test: add turn command state differential harness

2026-07-25 11:38:42 +00:00
parent 0151055f94
commit 111d3c7074
16 changed files with 1200 additions and 31 deletions
@@ -0,0 +1,42 @@
+import type { CanonicalTurnCommandTrace, TurnSnapshotSelector } from './canonical.js';
+import { readCoreDatabaseSnapshot } from './databaseSnapshot.js';
+
+export interface CoreTurnTraceRequest {
+    kind: 'general' | 'nation';
+    actorGeneralId: number;
+    action: string;
+    args: unknown;
+    observe: TurnSnapshotSelector;
+}
+
+export const captureCoreDatabaseTurnTrace = async (
+    databaseUrl: string,
+    request: CoreTurnTraceRequest,
+    execute: () => Promise<{
+        outcome?: unknown;
+        rng?: CanonicalTurnCommandTrace['rng'];
+    }>
+): Promise<CanonicalTurnCommandTrace> => {
+    const before = await readCoreDatabaseSnapshot(databaseUrl, request.observe);
+    const result = await execute();
+    const after = await readCoreDatabaseSnapshot(databaseUrl, {
+        ...request.observe,
+        logAfterId: request.observe.logAfterId ?? before.watermarks.logId,
+        messageAfterId: request.observe.messageAfterId ?? before.watermarks.messageId,
+    });
+    return {
+        schemaVersion: 1,
+        engine: 'core2026',
+        execution: {
+            kind: request.kind,
+            actorGeneralId: request.actorGeneralId,
+            action: request.action,
+            args: request.args,
+            seedDomain: request.kind === 'general' ? 'generalCommand' : 'nationCommand',
+            outcome: result.outcome,
+        },
+        before,
+        after,
+        rng: result.rng ?? [],
+    };
+};