PmjXM dZddlZddlZddlZddlmZdZdddeedzde e ee ffdZ dd d d e d e dee e ffdZdddededzde e ee ffdZdS)uDashboard process-hygiene helpers — extracted from ``hermes_cli/main.py``. Mechanical move (main.py decomposition): the three leaf process-hygiene helpers (``_scan_dashboard_processes``, ``_kill_stale_dashboard_processes``, ``_detect_concurrent_hermes_instances``) are lifted verbatim. References to helpers that STAY in ``hermes_cli.main`` (``_find_stale_dashboard_pids``, ``_respawn_dashboard_processes``, ``_is_windows``, ...) are routed through a lazy ``_m()`` main reference so existing test monkeypatches on ``hermes_cli.main.`` keep reaching this code path, and imports stay one-way at import time (main.py imports this module, never the reverse). ``main.py`` re-exports all three names (``# noqa: F401``) so callers and test patches on ``hermes_cli.main`` resolve unchanged. N)Pathcddlm}|S)zFLazy ``hermes_cli.main`` reference (call-time; keeps patches working).rmain) hermes_clirrs @/home/thesage/.hermes/hermes-agent/hermes_cli/dashboard_procs.py_mr s K exclude_pidsr returnc   gd}tj}g} tjdkr0ddlm}t jgdddddd | }|jdks|j gSd |j d D]}| }| dr|tdd  C| dr{|tdd }t fd|DrIt||kr6 |t| f#t"$rYwxYwnt jgdddddd}|jdkrt%|dd  d D]}| }|rd|vr| d d} t| dkrG t| d} n#t"$rYjwxYw| d t fd|Dr| |kr|| fn$#t&t jt*f$rgcYSwxYwrfd|D}|S)uDReturn matching ``dashboard``/``serve`` processes with their cmdlines. ``hermes dashboard`` is a long-lived server process commonly started and forgotten. When ``hermes update`` replaces files on disk, the running process keeps the old Python backend in memory while the JS bundle on disk is updated, causing a silent frontend/backend mismatch (e.g. new auth headers the old backend doesn't recognise → every API call 401s). The dashboard may be manually started or managed by the optional ``hermes-dashboard.service`` systemd unit. Managed units are restarted through their owning systemd scope; only manually-started processes use the kill path because we can't know their original launch args. *exclude_pids* is an optional set of PIDs that must never be returned. This is used by the Hermes Desktop Electron app to protect its own backend child process: when the desktop spawns ``hermes serve`` as a backend and triggers an auto-update, the update must not kill the backend that the desktop itself manages. The desktop sets the environment variable ``HERMES_DESKTOP_CHILD_PID`` on the spawned backend process; ``_kill_stale_dashboard_processes`` reads it and passes it here. (#37532) Returns an empty list on any scan error (missing ps/wmic, timeout, etc.). )zhermes dashboardzhermes_cli.main dashboardzhermes_cli/main.py dashboardz hermes servezhermes_cli.main servezhermes_cli/main.py servewin32r)windows_hide_flags)wmicprocessgetzProcessId,CommandLinez /FORMAT:LISTT utf-8ignore)capture_outputtexttimeoutencodingerrors creationflagsN z CommandLine=z ProcessId=c3 K|]}|vV dSN).0p current_cmds r z,_scan_dashboard_processes..gs(??A,??????r )psz-Az-oz pid=,command=replacerrrrrstdoutgrepc3 K|]}|vV dSr r!)r"r#commands rr%z,_scan_dashboard_processes..s'::A1<::::::r c(g|]}|dv |Srr!)r"procr s r z-_scan_dashboard_processes..s.   DG<4O4OD4O4O4Or )osgetpidsysplatformhermes_cli._subprocess_compatr subprocessrun returncoder)splitstrip startswithlenanyintappend ValueErrorgetattrFileNotFoundErrorTimeoutExpiredOSError) r patternsself_piddashboard_processesrresultlinepid_strstrippedpartspidr.r$s ` @@r_scan_dashboard_processesrPsU8   Hy{{H13E <7 " " I H H H H H^SSS# 0022F A%%)> K ++D11 ! !zz||??>22 !"&s>':':'<'<"=KK__\22 !"3|#4#4#6#67G????h?????!LLH44!/66G k7RSSSS)!!! D! !* ^333#GI F  A%%#FHb99??EE C CD#zz||H#!v'9'9 $NN433E5zzQ !!%(mm%!!! !#AhG:::::::::Csh+22C>BBB z8' B      0    scAI.B9I($E  I EIEBI2HI HIHAII;:I;:the running backend no longer matches the updated frontendF)restart_managedreasonrRc t  |r't|rgggdSd}tjd}|r{t }|dD]S}|}|s |t|=#ttf$rYPwxYw|r|}t |}|sgggdSttdt|d|di}i}i |rtjd kr|D]|} t| } | || <t| || <|| s(t| } | r| | <}ggtjd kr|D]} t)jd d t-| d gd d ddd} | jdkr| n7| | jp| jpdf#t6t(jt:f$r.} | t-| fYd} ~ d} ~ wwxYwnddl}ddl}|D]} tj | |j!#tD$r| Y?tFt:f$r.} | t-| fYd} ~ xd} ~ wwxYw|$dz}fd|D}|r|$|krt|%dg}ddl&m'}|D]8} || r|| #| 9|}|r|$|kt|D]} tj | |j(| 3#tD$r| YTtFt:f$r.} | t-| fYd} ~ d} ~ wwxYwD]} td| D]\} }td| d|g}g}r|rg}t }g}D]} || }|r||vr||t)||| r||~||df|| | vr| | || |D]}td||D]\}}td|d||rEt*|r"|+ fdD|s|rtdtd n/r-tY}td!td tY|tYtYtY|d"S)#u%Kill running ``hermes dashboard`` / ``hermes serve`` processes. Called at the end of ``hermes update`` (default ``reason``) and also from ``hermes dashboard --stop`` (which overrides ``reason``). The dashboard has no service manager, so after a code update the running process is guaranteed to be serving stale Python against a freshly-updated JS bundle. Leaving it alive produces silent frontend/backend mismatches (new auth headers the old backend doesn't recognise → every API call 401s). POSIX: SIGTERM, wait up to ~3s for graceful exit, SIGKILL any survivors. Windows: ``taskkill /PID /F`` since there's no clean SIGTERM equivalent for background console apps. Manually-started dashboards are not auto-restarted because we don't know the original launch args (--host, --port, --insecure, --tui, --no-open). When ``restart_managed`` is true (the ``hermes update`` path), a detected ``hermes-dashboard.service`` is restarted through systemd; any OTHER killed PID that was supervised by a systemd unit (custom unit names — e.g. a remote backend's ``hermes-serve.service``) has its owning unit restarted after the kill, because systemd treats our SIGTERM as a clean stop and ``Restart=on-failure`` would never fire (#68934). )matchedkilledfailedNHERMES_DESKTOP_CHILD_PID,r u ⟲ Stopping z dashboard process(es) ()rtaskkillz/PIDz/FTrr'rr(rrg@c8g|]}|v|dDv|S)ch|] }|d Sr0r!)r"fs r z=_kill_stale_dashboard_processes...s.sA   q1.Gs9"Z"Z 8J8Jk8Y8Y18Y8Y8Y8Y"Z"Zr z8 Restart anything not auto-restarted when you're ready:z" hermes dashboard --port z* Restart the dashboard when you're ready:)rUrVrW unrecovered)-r "_restart_managed_dashboard_servicer3environrsetr;r<addr@rB TypeError_find_stale_dashboard_pidsprintr>r5r6_get_pid_cgroup_path_get_systemd_service_for_pid_dashboard_cmdline_for_pidr8r9strr:rAstderrr)rDrErFsignaltimekillSIGTERMProcessLookupErrorPermissionError monotonicsleepgateway.statusr`SIGKILL_try_restart_systemd_service_respawn_dashboard_processesextendlist)!rSrRexcluderaw_pidparsedpartpids pid_cgroup pid_servicerOcg_pathcmdlinerJe_signal_timedeadlinepending still_pendingr`err_msgrestarted_servicesrdfailed_restarts seen_services respawn_cmdssvc_namesvcerrrWrbrVrcs! @@@@r_kill_stale_dashboard_processesrsL8;244BB6JJ;r::: $Gjnn788G 55MM#&&  D::<>/'.K$F$&F |w - -C -#S48#'   $))MM#&&&&MM3)M&-)M2(T(T(V(V"WXXX%z'@'J - - - sCFFm,,,,,,,, - - !    - -C -W_----% # # # c"""""#W- - - - sCFFm,,,,,,,, -??$$s*         $%//++h66 KK   M 3 2 2 2 2 2 ' ';s##'!((----MM#&&&&#G $%//++h66 - -C -W_--- c""""% # # # c"""""#W- - - - sCFFm,,,,,,,, -,, *S**++++>> W  >C Q<$Q77Q<) exclude_pid scripts_dirrctsgS ddl}n#t$rgcYSwxYwt }t|D]} |t| J#t$r7|t| YwxYw|sgS|t|h}ntj h} tt|} ||}n#t$rg}YnwxYw|D]} |} n#t$rY$wxYw| s+ tt'|  } n8#tt(f$r$t|  } YnwxYw| |vr9 |t|j#t$rYwxYwn#t$rYnwxYwg} |gd} n#t$rgcYSwxYw| D]'} | j}n#t$rYwxYw|d}|d}|r|||vrO tt'| }n8#tt(f$r$t| }YnwxYw||vrZ|dpt'|j}| t|t|f)| S)umFind other live processes whose .exe is one of our entry-point shims. Windows blocks DELETE/REPLACE on a running .exe — and even RENAME on the same .exe when another process opened it without ``FILE_SHARE_DELETE``. The Hermes Desktop Electron app spawns ``hermes.EXE`` as a backend child, so during ``hermes update`` the user-invoked process and the desktop's child both hold the same file. The quarantine rename then fails with ``[WinError 32]`` and uv inherits the lock. This helper enumerates processes whose ``exe`` matches one of the venv's shims (``hermes.exe`` / ``hermes-gateway.exe``) and returns ``(pid, process_name)`` pairs. The caller's own PID and its entire ancestor chain are excluded so the running ``hermes update`` invocation never reports itself — this matters on Windows where the setuptools .exe launcher (``hermes.exe``) is a separate process from the Python interpreter it loads (``python.exe``). Returns an empty list off-Windows, on missing psutil, or when no other instances exist. Never raises — process enumeration is best-effort. rN)rOexenamerOrr)r _is_windowspsutil Exceptionrg_hermes_exe_shimsrhroresolvelowerrFr@r3r4nextiterProcessparentsrrrBrO process_iterinforrrA)rrr shim_pathsshimr seed ancestorsancestoranc_exeanc_normmatches proc_iterr1rrOrexe_normrs r#_detect_concurrent_hermes_instancesrXsG. 44       55J&&{33.. . NN3t||~~..4466 7 7 7 7 . . . NN3t99??,, - - - - - .  ."%k"2"2!3  }  D&&'' t,,4466II   III !  H ",,..      0tG}}446677==??Z( 0 0 0w<<--// 0:%% $$S%6%67777 H&       &(G''(>(>(>??  22 9DD    H hhuoohhuoo ckSL%8%8  (499,,..//5577HH$ ( ( (3xx~~''HHH ( z ! !88F##5tCyy~D NNCHHc$ii0 1 1 1 Ns) 88-AB44>C54C5$I!'E)(I!) E85I!7E88I!FI! F"I!!F""I!)AG*)I!*2HI!HI!''II! II!II!! I.-I.4J JJ$J,, J98J90AL112M&%M&)rQ)__doc__r3r8r5pathlibrr rgr@r~tuplerorPbooldictrrr!r rrsa    %)uuuc(T/u %S/uuuupOC"CCC CC #t)_ CCCCL59rrrr'*Tzr %S/rrrrrrr