chore(run-ops): rename env var RUN_OPS_MINT_ENABLED and flag key runOpsMintKind

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

Author: d-cs

apps/webapp/app/env.server.ts

@@ -1728,9 +1728,9 @@ const EnvironmentSchema = z
     RUN_REPLICATION_NEW_ORIGIN_GENERATION: z.coerce.number().int().default(1),
 
     // 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
+    // Even when on, an env mints run-ops ids only if its per-org runOpsMintKind flag is
     // "runOpsId" AND isSplitEnabled() is true. Cache mirrors REALTIME_BACKEND_FLAG_CACHE_*.
-    RUN_OPS_MINT_KSUID_ENABLED: BoolEnv.default(false),
+    RUN_OPS_MINT_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/v3/featureFlags.ts

@@ -18,7 +18,7 @@ export const FEATURE_FLAG = {
   computeMigrationPaidPercentage: "computeMigrationPaidPercentage",
   computeMigrationRequireTemplate: "computeMigrationRequireTemplate",
   devBranchesEnabled: "devBranchesEnabled",
-  runOpsMintKsuid: "runOpsMintKsuid",
+  runOpsMintKind: "runOpsMintKind",
 } as const;
 
 export const FeatureFlagCatalog = {
@@ -52,8 +52,8 @@ export const FeatureFlagCatalog = {
   // Per-org access to development branches. Off unless enabled for the org.
   [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", "runOpsId"]),
+  // RUN_OPS_MINT_ENABLED is on AND isSplitEnabled() is true.
+  [FEATURE_FLAG.runOpsMintKind]: z.enum(["cuid", "runOpsId"]),
 };
 
 export type FeatureFlagKey = keyof typeof FeatureFlagCatalog;

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

@@ -33,7 +33,7 @@ describe("computeRunIdMintKind (pure)", () => {
 
   it("passes the already-loaded org feature flags through to the flag fn (no extra DB read)", async () => {
     const flag = vi.fn().mockResolvedValue("runOpsId");
-    const orgFeatureFlags = { runOpsMintKsuid: "runOpsId" };
+    const orgFeatureFlags = { runOpsMintKind: "runOpsId" };
     await computeRunIdMintKind(
       { organizationId: "org_1", id: "env_1", orgFeatureFlags },
       { masterEnabled: true, splitEnabled: async () => true, flag }

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

@@ -51,7 +51,7 @@ export async function resolveRunIdMintKind(environment: {
   orgFeatureFlags?: unknown;
 }): Promise<RunIdMintKind> {
   return computeRunIdMintKind(environment, {
-    masterEnabled: env.RUN_OPS_MINT_KSUID_ENABLED,
+    masterEnabled: env.RUN_OPS_MINT_ENABLED,
     splitEnabled: isSplitEnabled,
     flag: async (orgId, orgFeatureFlags) => {
       // The cache stores only "cuid"|"runOpsId" (never undefined), so the cache's
@@ -73,7 +73,7 @@ export async function resolveRunIdMintKind(environment: {
             )?.featureFlags;
 
       const kind = await flagFn({
-        key: FEATURE_FLAG.runOpsMintKsuid,
+        key: FEATURE_FLAG.runOpsMintKind,
         defaultValue: "cuid",
         overrides: (overrides as Record<string, unknown>) ?? {},
       });

apps/webapp/test/runOpsMintCutover.test.ts

@@ -48,7 +48,7 @@ async function seedOrgEnv(prisma: PrismaClient, mintFlag?: RunIdMintKind) {
   if (mintFlag) {
     await prisma.organization.update({
       where: { id: organization.id },
-      data: { featureFlags: { [FEATURE_FLAG.runOpsMintKsuid]: mintFlag } },
+      data: { featureFlags: { [FEATURE_FLAG.runOpsMintKind]: mintFlag } },
     });
   }
   return { organization, environment };
@@ -70,7 +70,7 @@ function realFlag(prisma: PrismaClient) {
             })
           )?.featureFlags;
     return flagFn({
-      key: FEATURE_FLAG.runOpsMintKsuid,
+      key: FEATURE_FLAG.runOpsMintKind,
       defaultValue: "cuid",
       overrides: (overrides as Record<string, unknown>) ?? {},
     });
@@ -145,7 +145,7 @@ describe("per-env run-ops-id mint cutover", () => {
       // Roll the org back to cuid (drain-new-forward — set the flag to "cuid").
       await prisma.organization.update({
         where: { id: a.organization.id },
-        data: { featureFlags: { [FEATURE_FLAG.runOpsMintKsuid]: "cuid" } },
+        data: { featureFlags: { [FEATURE_FLAG.runOpsMintKind]: "cuid" } },
       });
 
       // The NEXT run mints cuid again (the env-bound resolver's TTL cache is not used here,

packages/core/src/v3/isomorphic/runOpsResidency.ts

@@ -6,7 +6,7 @@ export type Residency = "LEGACY" | "NEW";
 /**
  * Underlying id lineage. "runOpsId" (formerly "ksuid") is the label for the
  * NEW-store mint path — a base32hex run-ops v1 id (see friendlyId.ts). It is
- * the value persisted in the runOpsMintKsuid feature flag. "cuid" is every
+ * the value persisted in the runOpsMintKind feature flag. "cuid" is every
  * legacy shape (cuid, nanoid, pre-cutover 27-char base62).
  */
 export type ResidencyKind = "cuid" | "runOpsId";