chore(run-ops): rename the "ksuid" mint-kind value to "runOpsId"

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: d-cs

.changeset/olive-bees-repeat.md

@@ -2,4 +2,4 @@
 "@trigger.dev/core": patch
 ---
 
-Change the run-ops run id format from a 27-char base62 KSUID to a 26-char lowercase base32hex id (ms timestamp + CSPRNG core, region char, version char) so run ids are DNS-1123 safe for Kubernetes pod names while staying lexicographically time-sortable
+Change the run-ops run id format from a 27-char base62 KSUID to a 26-char lowercase base32hex id (ms timestamp + CSPRNG core, region char, version char) so run ids are DNS-1123 safe for Kubernetes pod names while staying lexicographically time-sortable, and rename the exported `ResidencyKind` value `"ksuid"` to `"runOpsId"` to reflect that the NEW-store id is no longer a KSUID

apps/webapp/app/env.server.ts

@@ -1729,7 +1729,7 @@ const EnvironmentSchema = z
 
     // Run-ops id mint cutover — per-env, canary-first, OFF by default.
     // Even when on, an env mints run-ops ids only if its per-org runOpsMintKsuid flag is
-    // "ksuid" AND isSplitEnabled() is true. Cache mirrors REALTIME_BACKEND_FLAG_CACHE_*.
+    // "runOpsId" AND isSplitEnabled() is true. Cache mirrors REALTIME_BACKEND_FLAG_CACHE_*.
     RUN_OPS_MINT_KSUID_ENABLED: BoolEnv.default(false),
     RUN_OPS_MINT_FLAG_CACHE_TTL_MS: z.coerce.number().int().default(30_000),
     RUN_OPS_MINT_FLAG_CACHE_MAX_ENTRIES: z.coerce.number().int().default(10_000),

apps/webapp/app/runEngine/concerns/idempotencyResidency.server.test.ts

@@ -16,7 +16,7 @@ function makeDeps(over: Partial<ResolveIdempotencyClientDeps>): ResolveIdempoten
     fallbackClient: FALLBACK,
     newClient: NEW_CLIENT,
     legacyClient: LEGACY_CLIENT,
-    resolveMintKind: async () => "ksuid",
+    resolveMintKind: async () => "runOpsId",
     classify: (id) => {
       if (id.length === 26 && id[25] === "1") return "NEW";
       if (id.length === 25) return "LEGACY";
@@ -41,7 +41,7 @@ describe("resolveIdempotencyDedupClient", () => {
   it("routes a root run to the NEW client when the env mints run-ops ids", async () => {
     const client = await resolveIdempotencyDedupClient(
       { environmentForMint: env, parentRunFriendlyId: undefined },
-      makeDeps({ resolveMintKind: async () => "ksuid" })
+      makeDeps({ resolveMintKind: async () => "runOpsId" })
     );
     expect(client).toBe(NEW_CLIENT);
   });
@@ -67,7 +67,7 @@ describe("resolveIdempotencyDedupClient", () => {
     const cuidParent = RunId.toFriendlyId("b".repeat(25));
     const client = await resolveIdempotencyDedupClient(
       { environmentForMint: env, parentRunFriendlyId: cuidParent },
-      makeDeps({ resolveMintKind: async () => "ksuid" }) // mint flag must NOT win for a child
+      makeDeps({ resolveMintKind: async () => "runOpsId" }) // mint flag must NOT win for a child
     );
     expect(client).toBe(LEGACY_CLIENT);
   });

apps/webapp/app/runEngine/concerns/idempotencyResidency.server.ts

@@ -1,7 +1,7 @@
 import { ownerEngine, RunId, type Residency } from "@trigger.dev/core/v3/isomorphic";
 import type { PrismaClientOrTransaction } from "@trigger.dev/database";
 
-type MintKind = "cuid" | "ksuid";
+type MintKind = "cuid" | "runOpsId";
 
 export type ResolveIdempotencyClientDeps = {
   isSplitEnabled: () => Promise<boolean>;
@@ -52,5 +52,5 @@ export async function resolveIdempotencyDedupClient(
   }
 
   const kind = await deps.resolveMintKind(args.environmentForMint);
-  return clientFor(kind === "ksuid" ? "NEW" : "LEGACY");
+  return clientFor(kind === "runOpsId" ? "NEW" : "LEGACY");
 }

apps/webapp/app/runEngine/services/triggerFailedTask.server.ts

@@ -102,7 +102,7 @@ export class TriggerFailedTaskService {
           orgFeatureFlags: args.orgFeatureFlags,
         });
 
-    return mintKind === "ksuid"
+    return mintKind === "runOpsId"
       ? RunId.toFriendlyId(generateRunOpsId())
       : RunId.generate().friendlyId;
   }

apps/webapp/app/runEngine/services/triggerTask.server.ts

@@ -153,7 +153,7 @@ export class RunEngineTriggerTaskService {
           orgFeatureFlags: environment.organization.featureFlags,
         });
 
-    return mintKind === "ksuid"
+    return mintKind === "runOpsId"
       ? RunId.toFriendlyId(generateRunOpsId(region))
       : RunId.generate().friendlyId;
   }

apps/webapp/app/v3/featureFlags.ts

@@ -53,7 +53,7 @@ export const FeatureFlagCatalog = {
   [FEATURE_FLAG.devBranchesEnabled]: z.coerce.boolean(),
   // Per-org run-ops-id mint cutover. Defaults to "cuid"; only honored when
   // RUN_OPS_MINT_KSUID_ENABLED is on AND isSplitEnabled() is true.
-  [FEATURE_FLAG.runOpsMintKsuid]: z.enum(["cuid", "ksuid"]),
+  [FEATURE_FLAG.runOpsMintKsuid]: z.enum(["cuid", "runOpsId"]),
 };
 
 export type FeatureFlagKey = keyof typeof FeatureFlagCatalog;

apps/webapp/app/v3/runOpsMigration/mintBatchFriendlyId.server.test.ts

@@ -3,12 +3,12 @@ import { batchIdForMintKind, resolveBatchMintKind } from "./mintBatchFriendlyId.
 import { classifyKind } from "@trigger.dev/core/v3/isomorphic";
 
 describe("batchIdForMintKind (pure)", () => {
-  it("'ksuid' kind -> 26-char classifiable NEW batch id (no 21-char ids)", () => {
-    const r = batchIdForMintKind("ksuid");
+  it("'runOpsId' kind -> 26-char classifiable NEW batch id (no 21-char ids)", () => {
+    const r = batchIdForMintKind("runOpsId");
     expect(r.friendlyId.startsWith("batch_")).toBe(true);
     expect(r.id.length).toBe(26);
-    expect(classifyKind(r.id)).toBe("ksuid");
-    expect(classifyKind(r.friendlyId)).toBe("ksuid");
+    expect(classifyKind(r.id)).toBe("runOpsId");
+    expect(classifyKind(r.friendlyId)).toBe("runOpsId");
   });
 
   it("cuid -> 25-char classifiable LEGACY batch id", () => {
@@ -19,7 +19,7 @@ describe("batchIdForMintKind (pure)", () => {
   });
 
   it("never mints a 21-char id", () => {
-    for (const kind of ["cuid", "ksuid"] as const) {
+    for (const kind of ["cuid", "runOpsId"] as const) {
       expect([25, 26]).toContain(batchIdForMintKind(kind).id.length);
     }
   });
@@ -29,12 +29,12 @@ describe("resolveBatchMintKind", () => {
   const environment = { organizationId: "org_1", id: "env_1", orgFeatureFlags: {} };
 
   it("ROOT batch (no parent) resolves per-org kind via resolveRunIdMintKind", async () => {
-    const resolveRunIdMintKind = vi.fn().mockResolvedValue("ksuid");
+    const resolveRunIdMintKind = vi.fn().mockResolvedValue("runOpsId");
     const kind = await resolveBatchMintKind({
       environment,
       deps: { resolveRunIdMintKind },
     });
-    expect(kind).toBe("ksuid");
+    expect(kind).toBe("runOpsId");
     expect(resolveRunIdMintKind).toHaveBeenCalledWith({
       organizationId: "org_1",
       id: "env_1",
@@ -61,7 +61,7 @@ describe("resolveBatchMintKind", () => {
       deps: { resolveRunIdMintKind },
     });
 
-    expect(kind).toBe("ksuid");
+    expect(kind).toBe("runOpsId");
     expect(resolveRunIdMintKind).not.toHaveBeenCalled();
   });
 
@@ -81,9 +81,9 @@ describe("resolveBatchMintKind", () => {
 
   // mint-on-FLIP invariant: a child follows its parent's store even after the org flag
   // flips the other way. The flag resolver must NEVER be consulted for a child.
-  it("FLIP 'cuid'->'ksuid': a cuid (LEGACY) parent still mints a cuid child though the flag now says 'ksuid'", async () => {
+  it("FLIP 'cuid'->'runOpsId': a cuid (LEGACY) parent still mints a cuid child though the flag now says 'runOpsId'", async () => {
     const parentRunFriendlyId = `run_${"a".repeat(25)}`;
-    const resolveRunIdMintKind = vi.fn().mockResolvedValue("ksuid"); // flag flipped to ksuid
+    const resolveRunIdMintKind = vi.fn().mockResolvedValue("runOpsId"); // flag flipped to runOpsId
     const kind = await resolveBatchMintKind({
       environment,
       parentRunFriendlyId,
@@ -93,15 +93,15 @@ describe("resolveBatchMintKind", () => {
     expect(resolveRunIdMintKind).not.toHaveBeenCalled();
   });
 
-  it("FLIP 'ksuid'->'cuid': a run-ops (NEW) parent still mints a run-ops child though the flag now says 'cuid'", async () => {
+  it("FLIP 'runOpsId'->'cuid': a run-ops (NEW) parent still mints a run-ops child though the flag now says 'cuid'", async () => {
     const parentRunFriendlyId = `run_${"a".repeat(24) + "01"}`;
     const resolveRunIdMintKind = vi.fn().mockResolvedValue("cuid"); // flag flipped back to cuid
     const kind = await resolveBatchMintKind({
       environment,
       parentRunFriendlyId,
       deps: { resolveRunIdMintKind },
     });
-    expect(kind).toBe("ksuid");
+    expect(kind).toBe("runOpsId");
     expect(resolveRunIdMintKind).not.toHaveBeenCalled();
   });
 });

apps/webapp/app/v3/runOpsMigration/mintBatchFriendlyId.server.ts

@@ -14,7 +14,7 @@ const defaultDeps: ResolveDeps = {
 };
 
 export function batchIdForMintKind(kind: RunIdMintKind): { id: string; friendlyId: string } {
-  if (kind === "ksuid") {
+  if (kind === "runOpsId") {
     const id = generateRunOpsId();
     return { id, friendlyId: BatchId.toFriendlyId(id) };
   }

apps/webapp/app/v3/runOpsMigration/resolveInheritedMintKind.server.test.ts

@@ -5,8 +5,8 @@ const NEW_PARENT = `run_${"a".repeat(24) + "01"}`; // run-ops id-shape -> NEW
 const LEGACY_PARENT = `run_${"b".repeat(25)}`; // cuid id-shape -> LEGACY
 
 describe("resolveInheritedMintKind (pure id-shape, shared across all mint paths)", () => {
-  it("inherits a run-ops (NEW) parent by id-shape -> 'ksuid' kind", () => {
-    expect(resolveInheritedMintKind(NEW_PARENT)).toBe("ksuid");
+  it("inherits a run-ops (NEW) parent by id-shape -> 'runOpsId' kind", () => {
+    expect(resolveInheritedMintKind(NEW_PARENT)).toBe("runOpsId");
   });
 
   it("inherits a cuid (LEGACY) parent by id-shape -> cuid", () => {