asdf

Squash the current repository state back into one baseline commit while
preserving the README reframing and repository contents.

Constraint: User explicitly requested a single squashed commit with subject "asdf"
Confidence: high
Scope-risk: broad
Reversibility: clean
Directive: This commit intentionally rewrites published history; coordinate before future force-pushes
Tested: git status clean; local history rewritten to one commit; force-pushed main to origin and instructkr
Not-tested: Fresh clone verification after push

src/utils/cleanupRegistry.ts

@@ -0,0 +1,25 @@
+/**
+ * Global registry for cleanup functions that should run during graceful shutdown.
+ * This module is separate from gracefulShutdown.ts to avoid circular dependencies.
+ */
+
+// Global registry for cleanup functions
+const cleanupFunctions = new Set<() => Promise<void>>()
+
+/**
+ * Register a cleanup function to run during graceful shutdown.
+ * @param cleanupFn - Function to run during cleanup (can be sync or async)
+ * @returns Unregister function that removes the cleanup handler
+ */
+export function registerCleanup(cleanupFn: () => Promise<void>): () => void {
+  cleanupFunctions.add(cleanupFn)
+  return () => cleanupFunctions.delete(cleanupFn) // Return unregister function
+}
+
+/**
+ * Run all registered cleanup functions.
+ * Used internally by gracefulShutdown.
+ */
+export async function runCleanupFunctions(): Promise<void> {
+  await Promise.all(Array.from(cleanupFunctions).map(fn => fn()))
+}