+ iHj$$a0t$Rt^RIHt^RIt^RIt^RIt^RIHtH t H t ]P!R4t ]P!4tRt]!4tR]R&]!4tR]R&]!4tR]R &]!4tR]R &]!4tR]R &]!4tR]R &]]]]]]3tR RltRRltRRltRRltRRltRRltRRltRRlt RRlt!R3RR llt"R!R"lt#R#R$lt$R4R%R&llt%R'R(/R)R*llt&R+R,lt'R-R.lt(R/R0lt)R1R2lt*.R5Ot+R#)6a4Structured logging with steady-state silence for the LSP layer. LSP fires on every write_file/patch, so the level model keeps ``agent.log`` greppable (``rg 'lsp\['``) without noise: DEBUG for steady-state events with no novel signal (clean, skipped, repeat "no project root" / "server unavailable"); INFO for once-per-session transitions (first ``active for ``, first ``no project root`` per file) and every diagnostic event; WARNING for action-required failures (first ``server unavailable`` per (server_id, binary), every timeout / unexpected error). Dedup uses module-level sets bounded by the distinct pairs touched in one process, each capped at ``_ANNOUNCE_CAP`` keys: past it the bucket resets and the first-seen line re-fires once, so per-file keys can't grow for the life of a gateway process (#62950). ) annotationsN)ListOptionalTuplezhermes.lint.lspiset_announced_active_announced_unavailable_announced_no_root_announced_skipped_announced_excluded_announced_untrustedc V^8dQhRRRR/#) file_pathstrreturn)formats"7/home/ubuntu/.hermes/hermes-agent/agent/lsp/eventlog.py __annotate__r$s N N3 N3 NcV'gV#\PPV4pTP R\P ,4'gTR8XdT#T# \\3dTu#i;i)z\Render *file_path* relative to cwd when it's inside it, else absolute (no ``../..`` chains).z..)ospathrelpath ValueErrorOSError startswithsep)rrels& r _short_pathr $si ggooi( tbff}559M#M  sA""A87A8c(V^8dQhRRRRRRRR/#)r server_idrlevelintmessagerNoner)rs"rrr1s(;;S;;s;t;rc4\PVRW4R#)z lsp[%s] %sN) event_loglog)r"r#r%s&&&r_emitr*1s MM%y:rc4V^8dQhRRRRRRRRR RR RR R /#) rbucketrkeytupler"rr#r$firstrepeatrr&r)rs"rrr5sHZZsZZ3ZsZ3ZX[Z`dZrcF\;_uu_4W9pV'd%\V4\8dVP4VP V4RRR4\ TX'dTM\ PV'd V4R#T4R# +'giLG;i)zRLog *first* at *level* the first time *key* is seen, *repeat* at DEBUG thereafter.N)_announce_locklen _ANNOUNCE_CAPclearaddr*loggingDEBUG)r,r-r"r#r/r0is_firsts&&&&&& r _emit_oncer:5s\ $ F }4 LLN 3   )hUGMMH5YRXY s AB B c$V^8dQhRRRRRR/#rr"rrrr&r)rs"rrrBs&IIIIIrcV\V\PR\V4 R24R#)z/No diagnostics emitted for *file_path*. DEBUG.zclean ()Nr*r7r8r )r"rs&&r log_cleanr@Bs! )W]]gk).D-EQ$GHrc(V^8dQhRRRRRRRR/#)rr"rrreasonrr&r)rs"rrrGs.UUCUCUUUrc \\V\PRV R\V4 R24R#)zQLSP intentionally skipped for this file (feature off, ext unmapped, ...). DEBUG.z skipped:  (r>Nr?)r"rrBs&&&r log_disabledrEGs( )W]]ixr+i:P9QQR$STrc$V^8dQhRRRRRR/#)rr"rworkspace_rootrr&r)rs"rrrLs&VV#VsVtVrc X\\W3V\PRV 2RV 24R#)zXA client started for (server_id, workspace_root). INFO once per pair, DEBUG thereafter.z active for zreused client for N)r:rr7INFO)r"rGs&&r log_activerJLs1 9"=y',,^,-1CNCS/TVrc(V^8dQhRRRRRRRR/#)rr"rrcountr$rr&r)rs"rrrRs.PPsPsP3P4Prc Z\V\PV R\V4 R24R#)u[Diagnostics arrived for a file. INFO every time — rare per edit and what users grep for.z diags (r>N)r*r7rIr )r"rrLs&&&rlog_diagnosticsrNRs% )W\\eWH[5K4LA#NOrc$V^8dQhRRRRRR/#r<r)rs"rrrWs&^^3^3^4^rcfR\V4 2p\\W3V\PW"4R#)zMFile had no recognised project marker. INFO once per file, DEBUG thereafter.zno project root for N)r r:r r7rI)r"rmsgs&& rlog_no_project_rootrRWs- Y!7 8 9C!I#99gllTW]rc$V^8dQhRRRRRR/#)rr"r binary_or_pkgrr&r)rs"rrr]s!c#$rc Z\\W3V\PRV R2RV 24R#)zRServer binary unresolved. WARNING once per (server_id, binary), DEBUG thereafter.zserver unavailable: zR not found (install via `hermes lsp install ` or set lsp.servers..command)zserver still unavailable: N)r:rr7WARNING)r"rTs&&rlog_server_unavailablerW]s7 :Iw }o.R R $]O4 rc(V^8dQhRRRRRRRR/#)rr"rrkindrr&r)rs"rrrgs.XX3X3XcXdXrc X\V\PV R\V4 24R#)z7A request to the server timed out. WARNING every time.z timed out for N)r*r7rVr )r"rrYs&&&r log_timeoutr[gs# )W__ok)>T=U&VWrc(V^8dQhRRRRRRRR/#)rr"rrexc BaseExceptionrr&r)rs"rrrls.uuuu-uDurc \V\PR\V4 R\ V4P RV 24R#)z?An unexpected exception bubbled out of the LSP layer. WARNING.zunexpected error for : N)r*r7rVr type__name__)r"rr]s&&&rlog_server_errorrcls> )W__(=k)>T=UUWX\]`XaXjXjWkkmnqmr&strc(V^8dQhRRRRRRRR/#)rr"rrGr]r^rr&r)rs"rrrqs/tttSt}tQUtrc t\V\PRV R\V4P RV 24R#)z7The LSP server failed to spawn or initialize. WARNING.zspawn/initialize failed for r`N)r*r7rVrarb)r"rGr]s&&&rlog_spawn_failedrfqs9 )W__(D^DTTVW[\_W`WiWiVjjlmplq&rsrc ,V^8dQhRRRRRRRRRR/#) rr"rrGrretry_inzOptional[float]rr&r)rs"rrrvs8UU#UsUsUVeUquUrc VeRVR R2MRp\\W3V\PR\ V4 RV RV R 2R\ V4 RV R 24R#) a/A request was skipped because ``(server_id, root)`` is marked broken. INFO once per root, then DEBUG: at default log levels a skipped file and a clean file otherwise look identical (``log_clean`` is DEBUG). ``retry_in`` (seconds, from ``lsp.broken_retry_seconds``) names when the pair gets another try.Nz retry in .0fsz*no diagnostics for this root until restart skipping r`z) marked broken after an earlier failure (r>z marked broken)r:r r7rIr )r"rGrrhuntils&&&& rlog_skipped_brokenrnvsq,4+?i~Q 'EqE!I#> 7<<;y12"^4DDmnsmttuv;y12"^4DNSUrinvalidFc ,V^8dQhRRRRRRRRRR/#) rr"rrGrroboolrr&r)rs"rrrs8PPPcPcPW[PhlPrc V'dRMRp\\W3V\PR\ V4 RV RV 2R\ V4 RV R24R#)u``workspace_root`` matches ``lsp.exclude_roots`` (or the key is malformed and every root is skipped). INFO once per root — a deliberate gate must still be visible, or an excluded file looks like a clean one — DEBUG thereafter.z-lsp.exclude_roots is not a list (fix the key)zmatches lsp.exclude_rootsrlr` z excludedN)r:r r7rIr )r"rGrrowhys&&&$ rlog_root_excludedrus_>E 9JeC"Y$?GLL;y12"^4DAcUK;y12"^4DINPrc(V^8dQhRRRRRRRR/#)rr"rrGrrr&r)rs"rrrs/AASA#A#ARVArc r\\W3V\PRV R\ V4 R2RV 24R#)z``server_id`` is not safe in an untrusted workspace and ``workspace_root`` is not trusted. INFO once per root (a deliberate gate must not look like a clean file), DEBUG thereafter.zskipped: untrusted workspace rDz<); add it to lsp.trusted_workspaces to run this server thereN)r:r r7rIr )r"rGrs&&&rlog_untrusted_skippedrxsI#i%@)W\\.~.>bYAW@XYKK.~.>?Arc$V^8dQhRRRRRR/#)rkeyslist[tuple[str, str]] idle_timeoutfloatrr&r)rs"rrrs' m m* m% mD mrc \;_uu_4\PV4RRR4RPRV44p\ R\ P R\V4 RVR RV 24R# +'giLX;i) zIdle clients were reaped. INFO, one line per sweep. Also forgets the ``log_active`` announcement for those keys so a respawn re-announces at INFO instead of a misleading DEBUG "reused client". N, c36"TFwrV RV R2xK R#5irDr>Nr.0sidroots& r log_reaped..@4ic3%r$q)4reaperzreaped z idle client(s) after rjzs: r2rdifference_updatejoinr*r7rIr3)rzr|summarys&& r log_reapedrsg ++D1 ii@4@@G (GLLGCI;6L\Z]L^^abiaj"kl s A55 B c$V^8dQhRRRRRR/#)rrzr{rBrrr&r)rs"rrrs'[[,[c[d[rc \;_uu_4\PV4RRR4RPRV44p\ R\ P R\V4 RV RV 24R# +'giLW;i)zClients were shut down because their workspace went away (worktree released or root deleted). INFO, one line per event; forgets the ``log_active`` announcement like :func:`log_reaped`.Nrc36"TFwrV RV R2xK R#5irrrs& rrlog_released..rrrz released z client(s) (z): r)rzrBrs&& r log_releasedrs` ++D1 ii@4@@G (GLLIc$i[ VHCPWy"YZ s A44 B cV^8dQhRR/#)rrr&r)rs"rrrstrc\;_uu_4\FpVP4K RRR4R# +'giR#;i)zETest-only: clear the dedup caches. Production code never calls this.N)r2 _ALL_BUCKETSr5)r,s rreset_announce_cachesrs& "F LLN# s 7 A ) diagnostics)N)r(rJr@rNrErRrrurcrWrnrfr[rxr),__conditional_annotations____doc__ __future__rr7r threadingtypingrrr getLoggerr(Lockr2r4rr__annotations__rr r r r rr r*r:r@rErJrNrRrWr[rcrfrnrurxrrr__all__)rs@rrs# # ((   / 0 ! 3!e#%C%C5S Ec!!#9;MOacv$&  N;ZI U V P ^ X u t UP^cPA m[ r