"""Shared hook logic. Pure functions, no I/O."""