+ WjAVvRt^RIHt^RIt^RIt^RIt^RIt^RIt^RIt^RI t ^RI H t ^RI H t ^RIt]P !]4tRt^tR't^t!RR] 4tRR ltR R ltR tR tRtRRltRRltRRltRRlt RRlt!RRlt"RRlt#]3RRllt$RR lt%R!R"lt&R(R#R$llt'R%R&lt(R#))aScratch-dir retention: idle detection plus the reaping an idle tree needs before it goes. Deleting an idle ``cache/scratch/`` is not enough on its own: a lane's e2e run leaves headless browsers whose cwd was inside the tree (they survived for days with a ``(deleted)`` cwd), and a repo whose linked worktree lived in the tree keeps a dangling registration until someone runs ``git worktree prune``. Both are reaped here, right before ``rmtree``. A process Hermes itself started is never an orphan, though: an idle entry a registered live process still works inside is kept, not reaped (#132401). Ownership comes from the two registries Hermes writes, not from a marker file a lane must remember to drop. ) annotationsN)RotatingFileHandler)Pathg@c2a]tRt^(tRtRV3RlltRtV;t#)_PruneLogHandlera,Rollover that tolerates a concurrent prune of the same home rotating first: its rename of ``scratch-prune.log`` can land between this handler's existence check and its own rename. The rotation is then already done, so the record goes to the new file instead of being dropped with a FileNotFoundError.cV^8dQhRR/#)returnNone)formats"LC:\Users\johnn\AppData\Local\hermes\hermes-agent\hermes_constants_scratch.py __annotate___PruneLogHandler.__annotate__.s!!D!c <\P!\4;_uu_4\SV`4RRR4R# +'giR#;iN) contextlibsuppressFileNotFoundErrorsuper doRollover)self __class__s&r r_PruneLogHandler.doRollover.s/  !2 3 3 G  4 3 3 3s = A r )__name__ __module__ __qualname____firstlineno____doc__r__static_attributes__ __classcell__)rs@r rr(s/ !!rrc V^8dQhRRRR/#)rlog_file Path | Noner logging.Loggerr )r s"r rr3sknrc Vf\#VPPRRR7\ P !\P\ P4p\Tn\T\\RRRR7pTP\ P!R44TPT4T# \d2p\P RTPT4\uRp?#Rp?ii;i) aLogger for one prune's records, with its own RotatingFileHandler on *log_file*, so a prune that runs at boot (before ``setup_logging()``) still leaves them on disk. Records also propagate through this module's logger to whatever logging is set up. One unregistered logger per prune, closed when it ends: no process holds the file open between prunes (an open handle blocks rollover on Windows), and prunes of two homes never share a handler. Without a *log_file* (test-runner temp roots) this module's logger is used. NT)parentsexist_okz#scratch prune: cannot create %s: %sutf-8backslashreplace)maxBytes backupCountencodingerrorsdelayz%(asctime)s %(message)s)loggerparentmkdirOSErrorwarningloggingLoggernameINFOr_PRUNE_LOG_MAX_BYTES_PRUNE_LOG_BACKUPS setFormatter Formatter addHandler)r#excaudithandlers& r _open_prune_logrA3s dT: NN6;; 5EEL/=OZa!G **+DEF W L  1``) does not count either: its mtime is the inode's, and ``git clone --local`` hardlinks packs that git freshens from the source repo.) _scan_subtreerCrZs&&r subtree_touch_stater_ks  &q ))rc$V^8dQhRRRRRR/#)rrCrrZr[r ztuple[str, str | None]r )r s"r rrus"e0Frc\P!V4PV8d \R3#VP 4'dVP 4'd \ R3#\T4.pT'dTP4p\P!T4;_uu_4pTFpTPRR7pTPT8d>TP^8dTP!RR7'g\R3uuuRRR4#TP RR7'gK~TP#TP$4K RRR4K\ R3# \d \R3u#i;i \d=p\\P!T4'dTMR3uRp?uuuRRR4#Rp?ii;i +'giEK^;i \d1p\\P!T4'dTMR3uRp?#Rp?ii;i)z``(state, denied_dir)``: *denied_dir* is the directory below *path* that refused listing with EACCES/EPERM when that is why the scan failed (else None).NFrF)rHrIst_mtime_TOUCHEDrKrL_IDLEr3 _SCAN_FAILEDrMrOrNrPstuckis_permission_errorst_nlinkis_filerQrC)rCrZrScurrentrTrUstr>s&& r r]r]us" 88D> " "f ,T> !{{}} 1 1$; !2YKE ))+ UG$$Ea"ZZZ>{{f,bkkAo%--hm-JnJn'~-%$||E|:: UZZ0 %$ $;% "T!!"#a+8Q8QRU8V8VW\``` %$a %$$ UE,E,Ec,J,JPTT T Us,EEEE G'F<.E29F<: F< GF<(F<GE/.E/2 F9 =%F4 "F9 #F<) G4F9 9F<< G GG H %HH H c$V^8dQhRRRRRR/#)rrCrrZr[r boolr )r s"r rrs! 6 6 6e 6 6rc&\W4\8g#)u<True when *path* or anything beneath it has an mtime at or after *cutoff*. Stops at the first recent entry, so a live tree costs one hit and only a truly idle tree pays for the full walk (once, right before it is deleted). Symlinks are never followed: a link into the repo would make the target's activity keep the entry alive. An unreadable entry is kept: an incomplete scan cannot establish that it is idle — so True here means "touched **or** uninspectable", and callers that need to tell the two apart (the mid-prune audit) use :func:`subtree_touch_state` instead. )r_rdr^s&&r subtree_touched_sinceros t , 55rc$V^8dQhRRRRRR/#)rrCrMrootr rmr )r s"r rrs&IIICIDIrcW8H;'gDVPVP\P4\P,4#r) startswithrstriprHsep)rCrqs&&r _underrvs1 < H H4??4;;rvv+>+GHHrcV^8dQhRR/#)rr set[int]r )r s"r rrs  h rc^RIp\4pVP4pVe?VPV9d.VP VP4VP 4pKBV# TP \3dT#i;i)zOThis process and its ancestors: never reap the shell that is running the prune.N)psutilsetProcesspidaddr1Errorr3)rzpidsprocs r _own_lineagersrUD ~~4884#7 HHTXX ;;=D K LL' "  K sAA$$A?>A?c V^8dQhRRRR/#)rhomerr rxr )r s"r rrs))))rc ^RIp^RIHp^RIHpV!VR7pVR, R3.pYPV0Uu.uF qfR, R3NK up, p\ 4pVEFnwr\ P!VPR R 74p \T \4'dT M.EF"p \T \4'd#T PR 4T PT 43MRwr\T \4'dT ^8:gT PR R 4R 8wdKvT PR4R8XdT!T 4RJdKT fTP!T 4pMUT R8Xd=\#TP%T 4P'4\)T 4, 4R8pM^RIHpT!T 4T 8HpT'gEKTP3T 4EK% EKq V#uupi \\3dEKi;i TP.\\0\3dEKqi;i)a4Live pids Hermes registered for *home*: the machine spawn ledger (every long-lived entry point and MCP helper, ``hermes_cli.process_identity``) and the background-process checkpoint (``tools.process_registry``, ``processes.json``). A recorded start time that no longer matches is a reused pid, not ownership.N)spawner_is_dead)get_default_hermes_root)rzspawn-ledger.json create_timezprocesses.jsonhost_start_time utf-8-sig)r-r} pid_scopehostpurposez mcp-helperTg@)get_process_start_time)NN)rzhermes_cli.process_identityrhermes_constantsrr{jsonloads read_textr3 ValueError isinstancelistdictgetrD pid_existsabsr|rr[gateway.statusrr TypeErrorr~)rrzrrrqsourcesbaserrC stamp_keyentriesentryr}stampalivers& r _registered_live_pidsrs ;8 " -D**M:;G PTV((*;<VVGUD" jj!EFG!+7D 9 9WrAEEOPUW[E\E\%))E*EIIi,@AbnJCc3''3!8uyyf7UY_7_yy#|38NRV8V ="--c2E-/s 3 ? ? AE%L PQTWWEE2375@Eu +B #6 K;W $   (LL'9jA  s6G &G6G' AG'G'G$#G$'!H  H c V^8dQhRRRR/#)r registeredrxr rmr )r s"r rrs  x D rc$a^RIpVPS9;'gW\;QJd-V3RlVP44F 'gK R# R#!V3RlVP444# TP\ 3dR#i;i)zRegistered itself, or a descendant of a live registered process (a background shell's child). An orphan whose spawning shell is gone was reparented away from that lineage, so it is not owned and is still reaped.Nc3n<"TF*qPS9;'dVP^8gxK, R#5i)N)r}).0prs& r #_owned_by_hermes..s.,hYgTUUUj-@-O-OQUUaZ-OYgs55TF)rzr}anyr'rr3)rrrzs&f r _owned_by_hermesrsvxx:%hh,hY]YeYeYg,hhh,hY]YeYeYg,h)hh LL' "s-A4 A4"A4A4A4A44BBc(V^8dQhRRRRRRRR/#) r scratch_rootrdoomedz list[Path]r?r%r rDr )r s"r rrs/II4IINIhkIrc D a^RIp\PP\ V44pVUu.uF+p\PP\ V44NK- pp\ 4p\ \R4'd\P!4MRp.p .p VPR.4EFp Ve"V P4PV8wdK*V P4p T 'gKDT PR4p T 'dT R\R4)MT o\!ST4'gKT 'gh\PP#S4'dC\$;QJdT3RlT4F 'gK RM RM!T3RlT44'gKT P&T9dT MT P)T S34EK V 'd7\+\-V4P/4P0P04M \34pYU Uu.uFwr\5W4'gKW3NK upp ,pVFwp oVUu.uF?p\!S\PP\ V444'gK=VNKA upFWpVP7V4V P94pVP;R \P<!V4V P&V4KY K V U Uau.uF|wp oV S3V9gK\PP#S4'dC\$;QJdV3R lV4F 'gK RM RM!V3R lV44'gKxV S3NK~ p p pV 'g^#V FEwp oV P94pV P?4TP;R T P&TS4KG TPAV U Uu.uFwp pV NK upp \BR 7wppVFQp V PE4VPF8XdK%V PI4TP;R T P&4KS \JP;R\V 44\V 4#uupi TP\3dEKi;iuupp iuupi TP\3dRpELi;iuupp i TP\3dEKii;iuupp i TP\3dEKi;i)a,TERM (then KILL) same-user processes whose cwd is inside an entry about to be pruned, or is a path under *scratch_root* that no longer exists. Returns the count. Only the cwd is consulted: a process merely holding a file open inside scratch (an editor, a log tail) is not ours to kill, but one *living* in a directory we are about to delete, or in one already gone, has nothing left to run for. A process Hermes owns (:func:`_owned_by_hermes`) is never signalled; each doomed entry it works inside is dropped from *doomed* in place and recorded as kept. Ngetuidr}z (deleted)c3<<"TFp\SV4xK R#5ir)rv)rtcwd_paths& r r+reap_processes_rooted_in.. s9_W^RS&1:M:MW^sTF?uGscratch prune: kept %r — live Hermes process pid=%d (%r) works insidec 3<"TF7p\S\PP\ V444xK9 R#5ir)rvrHrCrealpathrM)rers& r rrs47slrghxIYIYZ]^_Z`Ia8b8blrs?Az.scratch prune: sent TERM pid=%d name=%r cwd=%r)timeoutz:scratch prune: sent KILL pid=%d (still running after TERM)z=scratch prune: reaped %d process(es) rooted in pruned entries)&rzrHrCrrMrhasattrr process_iteruidsrealcwdrr3endswithlenrvexistsrr}rQrrabsoluter1r{rremover7infofspath terminate wait_procs_REAP_GRACE_SECONDSstatus STATUS_ZOMBIEkillr0)rrr?rzrqrtargetsskipuidvictimslineagerrdeletedrrownedrrr7_rs&&& ` r reap_processes_rooted_inrs 77  C - .D178ArwwA'G8 >D X.."))+DC02G13G##UG, 499;#3#3s#:((*C ,,|,073+#l++,Sh%%  "''..22cc9_W^9_ccc9_W^9_6_6_D(Wg = =tX>N O-"X_&tL'9'B'B'D'K'K'R'RSdgdiJ glgNDIYZ^Ik''gl lEh!'VA6(BGGvgND($AQY^A^x00CC7slr7sCCC7slr7s4s hgGv !h 99;D NN   CTXXtU]^ "  g!>g74$g!>H[ \HAu {{} 4 44 IIK  OQUQYQYZ KKOQTU\Q]^ w<w9 g&   mVLL'*   v g&   "? g&   s1R 7#RRR-5R-:R3R3/R8?S$S7 SSS9S S)S= T/TR*)R*8SSS:9S:TTc V^8dQhRRRR/#)rrrr set[str]r )r s"r rr7s$8rc N\4p\V4^3.pV'EdVP4wr4\P!V4;_uu_4pVEFpVP R8XEdVP RR7'd\VP4PRRR7P4pTPR4'd\T\R4RP44pTPP R 8XddTPPP R8Xd<TP\TPPP44EKEKEK EK#VP!RR7'gEK>V\"8gEKLVP R 9gEK`VP%VPV^,34EK RRR4EKV# \dEKi;i +'giEK;i \dEK i;i) ziRepos whose linked worktrees live inside *entry* (``.git`` FILES, ``gitdir: /.git/worktrees/``).z.gitFrFrreplace)r-r.zgitdir:N worktrees) node_modulesz.venvvenv)r{rMrOrHrNr7rirrCrstripr3rsrr1r~rK_GIT_FILE_MAX_DEPTHrQ) rreposrSrjdepthrTrUlinegitdirs & r _linked_worktree_reposr7seE%j!_ E % G$$EzzV+ e 0T0T%#' #3#=#={[d#=#e#k#k#mD ??955%)$s9~*?*E*E*G%HF%}}11[@V]]EYEYE^E^bhEh % #fmm.B.B.I.I*J KFi@6 e<<I\A\ % 2S S ejj%!)%<= %$" L '%$% %$$   slH0G?4G,9G?B>G?G?"G?6)G?H, G< 7G?;G< <G?? H HH H$#H$c V^8dQhRRRR/#)rrrr r r )r s"r rrRs K K Kd Krc Z\V4F\p\PPV4'gK*\P !RRVRR.\P RRRR^RR 7K^ R # \\P3d"p\PR Y4R p?KR p?ii;i) zT``git worktree prune`` in each repo: drops registrations whose tree we just deleted.gitz-CworktreepruneTr)rF)stdincapture_outputtextr-r.rcheckz#git worktree prune in %s failed: %sN) sortedrHrCisdir subprocessrunDEVNULLr3SubprocessErrorr0debug)rrepor>s& r release_git_worktreesrRsu ww}}T""  K NNdJ8 ((DSZcl%  334 K LL> J J Ks1A..B* B%%B*c ,V^8dQhRRRRRRRRR R /#) rrqrmax_idle_hoursr[ skip_namesfrozenset[str]r#r$r rDr )r s"r rras4   % 3A MX  rc\V4p\WW$4V\Jd%VPFpVP 4K ## T\Jd%TPFpTP 4K ii;i)aHDelete top-level entries of *root* with no write anywhere in their subtree for *max_idle_hours*, reaping processes and worktree registrations rooted in them first. Each removal, each signalled process and each entry rescued mid-prune (touched again after selection) is recorded in *log_file*. Returns the count actually removed.)rA_prune_idle_entriesr0handlersclose)rqrrr#r?r@s&&&& r prune_idle_entriesrasf H %E "4K   >> * 5  >> * s A0A7c ,V^8dQhRRRRRRRRR R /#) rrqrrr[rrr?r%r rDr )r s"r rrrs;gg g %g3AgJXggrcv\P!4VR,, pV\P!V4,\P\P0,pVP 4Uu.uFqUP V9gKVNK pp.pTFjp\YT4wrT\8XdTPT4K.T fK4\P!4'gKQ\P!YT .T4Kl \YT4T'g^#\#4p ^p TEFp T P%4'd)T P'4'gT \)T 4,p \+T 4p\-Y4pT\8wd\.P0!T 4RpT'd(TP5R\.P6!T 44MXT\88Xd(TP5R\.P6!T 44M&TP5R\.P6!T 44EK.pT P%4'd.T P'4'g\P:!T 4pMT P=4\.P0!T 4T'd5\P!4'd\P!Y TT4M&TP5R \.P6!T 44EK \?T 4T #uupi \d^#i;i \d$p \P!RT RR7Rp ? EL@Rp ? ii;i \2dRpEL\dRpELi;i \d4p TP5R \.P6!T 4T 4Rp ? EKRp ? ii;i \2dM8\d,TP5R \.P6!T 44EKi;iTP5R \.P6!T 4T4T ^, p EK ) iNz'scratch prune: process reap skipped: %sT)exc_infoFz0scratch prune: entry %r vanished since selectionu;scratch prune: rescued %r — touched since selection, keptuBscratch prune: kept %r — activity re-scan failed, left untouchedz&scratch prune: could not remove %r: %sz(scratch prune: could not fully remove %rz.scratch prune: could not confirm removal of %rz$scratch prune: removed %r (%d bytes)) timerf load_skipsSTUCK_STATE_NAMESTUCK_LOCK_NAMEiterdirr7r3r]rdrQtracking_supportedrecordr Exceptionr0rr{rKrLrrVr_rHrIrrrrc#rmtree_collecting_permission_errorsunlinkr)rqrrr?rZrrrstate denied_dirr>rremovedrsize entry_gonedenieds&&&& r rrrsBYY[>D0 0Fe..t448N8NPUPePe7ffJ"llnInj0H11nIF )!4 E> MM!   #(@(@(B(B LL:, 6T u5 eEG <<>>%"2"2"4"4 +E2 2E5!#E2 E> #"  MryyY^O_`(" QIIe$  XIIe$  ||~~e&6&6&8&8BB5I   HHUO%2244 T&%8 EryyQVGWX AP% NJ  T >d SSTB% "!  #"  #*  JJ?5AQSV W  !    JJGSXIY Z    9299U;KTR1 s'L9LLL L.M8NN$N;N O+O?OL L+*L+. M9MM M?/M?8M?>M? O 'N;;O PP'PPiPr))r __future__rrrr5rHshutilrrlogging.handlersrpathlibrhermes_constants_scratch_stuckrf getLoggerrr0rrr9r:rrArVrcrerdr_r]rorvrrrrrrrrr rr rs #   0.   8 $' !*!:,  *: 6I )X ^dIX6 K "gr