TaskRegistry

Thread-safe global registry mapping task IDs to their suspend handler functions.

Tasks must be registered before being enqueued. KMPWorker intentionally avoids reflection and annotation processing in favour of explicit registration.

Threading contract: register() and unregister() should be called from the main thread during app initialization, before any background tasks start. This matches the standard pattern used by WorkManager and BGTaskScheduler — workers are always registered at startup, not mid-execution.

Usage:

TaskRegistry.register("sync-users") { ctx ->
    println("Running task ${ctx.taskId}, attempt ${ctx.retryCount}")
    repository.syncUsers()
}
TaskRegistry.execute("sync-users", TaskExecutionContext("sync-users", retryCount = 0))