fix(webapp): dedupe bulk replay triggers

.server-changes/bulk-replay-idempotency.md

@@ -0,0 +1,6 @@
+---
+area: webapp
+type: fix
+---
+
+Prevent duplicate bulk replay attempts from creating multiple replayed runs for the same source run

apps/webapp/app/v3/services/replayTaskRun.server.ts

@@ -61,6 +61,9 @@ export class ReplayTaskRunService extends BaseService {
     const payloadType = payloadPacket.dataType;
     const metadata = overrideOptions.metadata ?? (await this.getExistingMetadata(existingTaskRun));
     const tags = overrideOptions.tags ?? existingTaskRun.runTags;
+    const idempotencyKey = overrideOptions.bulkActionId
+      ? `bulk-replay:${overrideOptions.bulkActionId}:${existingTaskRun.id}`
+      : overrideOptions.idempotencyKey;
     // Only use the region from the existing run if V2 engine and neither environment is dev
     const ignoreRegion =
       existingTaskRun.engine === "V1" ||
@@ -100,7 +103,7 @@ export class ReplayTaskRunService extends BaseService {
               ? new Date(Date.now() + overrideOptions.delaySeconds * 1000)
               : undefined,
             ttl: overrideOptions.ttlSeconds,
-            idempotencyKey: overrideOptions.idempotencyKey,
+            idempotencyKey,
             idempotencyKeyTTL: overrideOptions.idempotencyKeyTTLSeconds
               ? `${overrideOptions.idempotencyKeyTTLSeconds}s`
               : undefined,

apps/webapp/test/replayTaskRunIdempotency.test.ts

@@ -0,0 +1,74 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+vi.mock("~/db.server", () => ({ prisma: {}, $replica: {} }));
+
+vi.mock("~/models/runtimeEnvironment.server", () => ({
+  findEnvironmentById: vi.fn(async () => ({
+    id: "env_1",
+    type: "PRODUCTION",
+    archivedAt: null,
+  })),
+}));
+
+const triggerCall = vi.fn(async () => ({
+  run: { id: "run_new", friendlyId: "run_new_friendly" },
+  isCached: false,
+}));
+
+vi.mock("~/v3/services/triggerTask.server", () => ({
+  TriggerTaskService: class {
+    call = triggerCall;
+  },
+  OutOfEntitlementError: class OutOfEntitlementError extends Error {},
+}));
+
+import { ReplayTaskRunService } from "~/v3/services/replayTaskRun.server";
+
+const SOURCE_RUN = {
+  id: "run_source_internal",
+  friendlyId: "run_source_friendly",
+  taskIdentifier: "hello-world",
+  runtimeEnvironmentId: "env_1",
+  payload: JSON.stringify({ message: "hi" }),
+  payloadType: "application/json",
+  seedMetadata: null,
+  seedMetadataType: "application/json",
+  runTags: [],
+  queue: "task/hello-world",
+  workerQueue: "worker-queue-1",
+  concurrencyKey: null,
+  machinePreset: "small-1x",
+  isTest: false,
+  engine: "V2",
+  region: null,
+  traceId: "trace_1",
+  spanId: "span_1",
+  realtimeStreamsVersion: "v1",
+} as any;
+
+function makeFakePrisma() {
+  return {
+    runtimeEnvironment: {
+      findFirstOrThrow: vi.fn(async () => ({ id: "env_1", type: "PRODUCTION" })),
+    },
+    taskQueue: {
+      findFirst: vi.fn(async () => null),
+    },
+  } as any;
+}
+
+describe("ReplayTaskRunService idempotency (TRI-10467 fix #3)", () => {
+  beforeEach(() => {
+    triggerCall.mockClear();
+  });
+
+  it("sets a stable idempotency key for bulk replay source runs", async () => {
+    const service = new ReplayTaskRunService(makeFakePrisma());
+
+    await service.call(SOURCE_RUN, { bulkActionId: "bulk_1", triggerSource: "dashboard" });
+
+    expect(triggerCall.mock.calls[0][2].options.idempotencyKey).toBe(
+      "bulk-replay:bulk_1:run_source_internal"
+    );
+  });
+});