߲j@RUdZddlmZddlZddlmZmZddiZded< d d d Z y) uHeal mixed ``sys.modules`` after an in-place checkout update. Pre-reexec updaters (Hermes ≤ v2026.9.14) purged only package prefixes (``hermes_cli``, ``gateway``, ``tools``, ``tui_gateway``, ``agent``) and left root modules like ``utils`` cached in the updater process. The post-pull gateway-restart phase then imports new ``hermes_cli.gateway`` / ``hermes_cli.config`` into that process; those need symbols the stale ``utils`` lacks (``file_signature``), and ``hermes update`` exits 1 with ``gateway auto-restart failed: cannot import name 'file_signature' from 'utils'``. Post-swap hand-off (``hermes_cli.update_handoff``) makes this class dead for updaters that already include it. This module is the bridge for the one upgrade from a pre-handoff release onto a tree that needs new root symbols: freshly imported ``hermes_cli`` code drops the incomplete cache before importing ``utils``. ) annotationsN)MappingSequenceutils)file_signaturezdict[str, tuple[str, ...]]_ROOT_MODULE_REQUIRED_ATTRSc |tn|}g}|jD]m\}}tjj |(t fd|Ds=tjj |d|j|o|S)zGDrop cached root modules missing required attrs. Returns dropped names.Nc38K|]}t| ywN)hasattr).0attrmods =/home/ubuntu/.hermes/hermes-agent/hermes_cli/stale_modules.py z*drop_stale_root_modules..*s8$73%%8s)ritemssysmodulesgetanypopappend)requiredchecksdroppednameattrsrs @rdrop_stale_root_modulesr s}-5,< ((FG||~! ekkood# ;  8%8 8 KKOOD$ ' NN4 ! Nr )rz"Mapping[str, Sequence[str]] | Nonereturnz list[str]) __doc__ __future__rrtypingrrr__annotations__rrrr&sG$# $  ;7 48 0  r