suspend fun handleReferral(url: String): Boolean
Decodes referral context, guards self-referral, tracks arrival. Not a “stop routing” signal.