feat(webapp): boot global flags registry

Author: nicktrn

apps/webapp/app/entry.server.tsx

@@ -43,6 +43,8 @@ import { registerRunChangeNotifierHandlers } from "./services/realtime/runChange
 import { sessionsReplicationInstance } from "./services/sessionsReplicationInstance.server";
 (globalThis as Record<string, unknown>).__sessionsReplicationInstance =
   sessionsReplicationInstance;
+import { globalFlagsRegistry } from "./v3/globalFlagsRegistry.server";
+(globalThis as Record<string, unknown>).__globalFlagsRegistry = globalFlagsRegistry;
 
 const ABORT_DELAY = 30000;
 

apps/webapp/app/v3/globalFlagsRegistry.server.ts

@@ -0,0 +1,19 @@
+import { singleton } from "~/utils/singleton";
+import { env } from "~/env.server";
+import { flags } from "~/v3/featureFlags.server";
+import type { FeatureFlagCatalog } from "~/v3/featureFlags";
+import { createReloadingRegistry } from "~/utils/reloadingRegistry.server";
+
+/**
+ * In-memory snapshot of the global feature flags, refreshed every
+ * GLOBAL_FLAGS_RELOAD_INTERVAL_MS. `flags()` reads the DB-backed global values
+ * (no per-org overrides). Read synchronously on the trigger hot path; callers
+ * gate the first read on `waitUntilReady`.
+ */
+export const globalFlagsRegistry = singleton("globalFlagsRegistry", () =>
+  createReloadingRegistry<Partial<FeatureFlagCatalog>>({
+    name: "global-flags",
+    intervalMs: env.GLOBAL_FLAGS_RELOAD_INTERVAL_MS,
+    load: () => flags(),
+  })
+);