߲j@UdZddlmZddlZddlZddlZddlZddlZddl Z ddl m Z ddl m Z ddlmZmZmZmZmZddlmZej,dd d Zej1Zd Zd Zhd ZGddeZe dGddZej@Z!da"de#d<d3dZ$d4dZ%d5d6dZ&d5d7dZ'd8dZ(d9dZ)ej@Z*iZ+de#d<d:dZ,d5d;dZ-ej@Z.iZ/d e#d!<dd(Z4d?d)Z5d5d@d*Z6dd+dAd,Z7dd+dBd-Z8e9Z:d.e#d/<e;d0jye=Z>dCd1Z?dDd2Z@y)EuPlugin compatibility with the Sep 2026 decomposition: detect, warn, and (after the date) disable. The decomposition (PR #102117) moved most of Hermes's internals into ``_`` sibling modules. Old import paths keep resolving through ``PLUGIN-COMPAT`` blocks until :data:`COMPAT_REMOVAL_DATE`, when the commit that added them is reverted. This module is the single source of truth for everything that tells plugin authors and users about that: * :func:`scan_plugin` — static AST scan of one plugin directory for imports of manifest names. * :func:`compat_report` — ``{plugin_name: [Hit, ...]}`` across the user's ENABLED external plugins, cached. * :func:`removal_in_effect` — True once today >= the removal date (or the layer is already gone). * :func:`warn_once` — the per-name runtime warning emitted by the PLUGIN-COMPAT ``__getattr__`` blocks. Surfaces that read from here: the CLI banner, ``hermes plugins compat``, ``hermes doctor``, the post-update notices, the TUI/Desktop ``plugins.compat_report`` RPC, and ``PluginManager`` (which skips a hitting plugin after the date unless ``plugins.allow_deprecated_imports: true``). This module is part of the compat layer and is removed with it. ) annotationsN) dataclass)Path)DictIterableListOptionalTuple)atomic_json_writei allow_deprecated_importszcompat_manifest.json>.git.venvtestvenvtests __pycache__ node_modulesceZdZdZy)HermesPluginCompatWarningz@A plugin imported a name from its pre-decomposition module path.N)__name__ __module__ __qualname____doc__=/home/ubuntu/.hermes/hermes-agent/hermes_cli/plugin_compat.pyrr'sJrrT)frozenc6eZdZUded<ded<ded<ded<y)HitstrfileintlineoldnewN)rrr__annotations__rrrr!r!+s I I H Hrr!#Optional[Dict[str, Dict[str, str]]]_manifest_cachecrttjjjtz SN)r__file__resolveparent_MANIFEST_NAMErrr manifest_pathr19s& > ! ! # * * 1 1N BBrc t5ttcdddSi}t}|jr t j |j ddD]v}|jdxsd}|jdr|dd |d d }n$|jd |d zr|}n |d |d }||j|di|d <x |a|cdddS#t$ri}YwxYw#1swYyxYw) zS``{facade_module: {name: new_dotted_path}}``; ``{}`` when the compat layer is gone.Nutf-8)encodingentriestarget(facade.nameu, (removed; no replacement — vendor a copy)) _manifest_lockr*r1existsjsonloads read_textget startswithendswith setdefault Exception)outper6r's r load_manifestrI=s   &"*, O 88: AKKK$AB9MEAUU8_2F((-!"8 Qqyk9efqy9$!'!F)5ADCNN1X;3AfI>E'   !s4 C:C:B!C)C:) C74C:6C77C::Dctjsy|xstjj t k\S)zaTrue when hitting plugins must be disabled: the date has passed or the layer is already reverted.T)r1r=_dtdatetodayCOMPAT_REMOVAL_DATErMs rremoval_in_effectrPVs/ ? ! ! #  %SXX^^%*= ==rcht|xstjjz jSr,)rNrKrLrMdaysrOs rdays_until_removalrS]s# 5# A9A9A9A>$A>c  tj|}g}i}tj|D]$}t |tj r|j |vr|jdk(r|jD]x}|j||j vs|jt||j|j d|j||j |jzt |tjs|jD]8}|j|vs|j||jxs |j<:'tj|D]}t |tjrt |j tj"r|j j$|vrr||j j$}|j&||vs|jt||j|d|j&|||j&t |tjrg} |} t | tjrB| j| j&| j } t | tjrBt | tj"sc| j| j$| j)t+dt-| D]Z} dj/| d| | | } } | |vs!| || vs)|jt||j| d| || | \t |tj0st |j t2s:d|j vsJ|j j5d\} }} | |vso| || vsx|jt||j|j || | t7t9|dS#t$rgcYSwxYw)zHits in one file: ``from F import n``, ``import F`` + ``F.n``, ``import F as a`` + ``a.n``, and string targets ``"F.n"`` (``patch``/``import_module``).rr:NcH|j|j|jfSr,)r#r%r&)hs rzscan_source..sAFFAFFAEE+Br)key)astparse SyntaxErrorrV isinstance ImportFrommodulelevelnamesr;appendr!linenoImportasname AttributevalueNameidattrreverserangelenjoinConstantr" rpartitionsortedset)srcrelmanifesttreehitsaliasesnodeafacpartscurimodr;_s r scan_sourcerks_yy~D G9 dCNN + x0GDJJZ[OZZ q66Xdkk22KKC Qqvvh6OQYZ^ZeZeQfghgmgmQn op qcjj )ZZ 966X%23&&GAHH./ 9 9T dCMM *z$**chh/OTXT^T^TaTaelTl$**--(CyyHSM) CT[[SE499+2FQT VZV_V_H`ab cmm ,!ECS#--0 SXX&iiS#--0#sxx( SVV$ q#e*-aA #r 3U1XCh48C=+@ CT[[SE4&/8TW=Y]K^$_`acll + 4::s0KPSW[WaWaPa::005LCDh48C=#8 CT[[$**hsmD>QRS-T0 #d)!B CCK  sP66 QQz=Dict[str, Tuple[Tuple[Tuple[str, int, int], ...], List[Hit]]] _scan_cachecg}t|D]S} |j}|jt |j ||j |jfUtt|S#t$rYuwxYw)u``(relpath, mtime_ns, size)`` of every ``.py`` under the plugin — the cache key for a scan. A stat walk costs ~1 ms; the AST scan it replaces costs ~10 ms per file.) r^statOSErrorrmr" relative_to st_mtime_nsst_sizetupler|) plugin_dirsigrGsts r_plugin_dir_signaturers C j !Q B C j12BNNBJJOP Q     sA88 BBct}||n|}||u}|r|rt|jsgSt|}t|j d}|r t |nd}|r%j1BI  * __S)F *  &)y"8q ? "D j !Q ++wy+AC Cz!:!C!C!ExPPQ  7 )4:6K  7 K4K! * *     7 Ks*1D#8D/D>#D,/ D;:D;>Ez+Dict[Tuple[str, ...], Dict[str, List[Hit]]] _report_cachect|dddk(s t|ddsyt|j}t|dddk(rnddl} |jj |j dd}t|d d}|r|d vryt|}|jd k(r |jSdSt|}|jr|SdS#ttf$rd}YnwxYw) uxDirectory to scan for ONE manifest, or None when there is nothing safe to scan. Directory plugins carry their own dir. Entry points carry ``module:attr``: resolve the module through import metadata to its installed package dir. Never fall back to a relative path — that made ``C:\...`` and ``pkg:attr`` scan the CWD and attribute stray files to the plugin. sourcer7bundledpathN entrypointr:origin)zbuilt-inrz __init__.py) getattrr"rimportlib.utilutil find_spec partition ImportError ValueErrorrr;r/r)rraw importlibspecrrGs r _scan_rootrsx2&)378VUY;Z hmm Cx2&,6 >>++CMM#,>q,ABDx.#99 L66]2qxx<< S A 1$$Z( D s -CC%$C%F)forcec|O ddlm}|}|j|jj Dcgc]}|j }}|Dcgc]#}t|dddk7st|dds"|%}}ttd|D}t5|s|tvrt|cdddSdddt}i} |D])}tt||} | s| | |j<+t5| t|<dddt!| | Scc}w#t $ricYSwxYwcc}w#1swYxYw#1swY=xYw) z``{plugin_name: hits}`` for every ENABLED external (non-bundled) plugin with at least one hit. ``manifests`` defaults to the current PluginManager's discovered manifests. Cached per manifest set. Nr)get_plugin_managerrr7rrc3RK|]}|jd|j!yw)@N)r;r).0ms r z compat_report..s#>!&&166(+>s%')hermes_cli.pluginsrdiscover_and_load_pluginsvaluesrrErrr| _report_lockrrIrrr;_write_report_file) manifestsrrmgrlprexternalrdrrFrs r compat_reportrsQ   =$&C  ! ! #/2||/B/B/DEEIE%ka8R(@I(MRYZ[]ceiRjkHk >X>> ?C & - %&&&H "C :a=(3 CK ! c!s J#F I k&&!!sL9D*D%D*D;, D;:D;!E E %D** D87D8E  Ez.plugin-compat-report.jsonc*ddlm}|tz S)Nrget_hermes_home)hermes_constantsr REPORT_FILErs rreport_file_pathr s0  { **rc  t}|s!|jr|jytt t j jt jjjd|jDcic] \}}||Dcgc]}|jc}"c}}}t|d}t||dycc}wcc}}}w#t$rYywxYw)a#Persist the latest report for surfaces without a Python runtime handy (the Desktop boot modal). Written on every scan so a fixed plugin clears the notice on the next start; removed outright when there is nothing to report so a stale file can never resurface a resolved warning. Nseconds)timespec) removal_date in_effect written_atpluginslinesr`)indent)rr=unlinkCOMPAT_REMOVALrPrKdatetimenowtimezoneutc isoformatitems__dict__ summary_linesr rE)reportrGkvrbpayloads rrrs   xxz #1@Q@S!$!1!1#,,2B2B!C!M!MW`!M!aFLllnUUdaqq"9!1::"99U)&13 !WQ/#:U    s;,C(A(C( C!$C7C!<C(C!!C(( C43C4c*tt|S)z?Hits for ONE manifest (used by the loader before importing it).)rr)rs r plugin_hitsr#s z(+ ,,rc | ddlm}|}|xsijdxsijtdduS#t$rYywxYw)zX``plugins.allow_deprecated_imports: true`` keeps hitting plugins loading after the date.r)load_config_readonlyrFT)hermes_cli.configrrA ALLOW_KEYrE)configrs rrr(sU > >)+F2""9-388EJdRR s=A A  A rOct|r tryt|}|sydt|dtdt dS)z]Why the loader must skip this plugin now, or None. Only ever non-None after the removal date.Nzuses z import path(s) removed on zN; run `hermes plugins compat` for the list, update the plugin, or set plugins.z: true to force-load)rPrrrxrr)rrMrs rdisable_reasonr4sP U #'?'A x D CI;9.9IJ??HkI] _`rc |sgSt|}djdt|jD}t |r/t r%|d|dk7rdnddt dtd | }d }||gSt |r&|d|dk7rdndd td |}d t d }||gSt|}|d|dk7rdndd|dk(rdnddtd|d|dk7rdndd| }d}||gS)zIPlain-text lines for banners/notices; empty when there is nothing to say.z, c3DK|]\}}|dt|dyw) ()N)rx)rrrs rrz summary_lines..Ds%KDAq2c!fXQ'Ks z pluginr`sr7z force-loaded via plugins.z: they import paths removed on z: zSUpdate the plugin(s); the old paths no longer exist. Details: hermes plugins compatz( DISABLED: they import paths removed on z$Update the plugin(s) or set plugins.z4: true to force-load. Details: hermes plugins compatz usez# import paths that stop working on rz dayz): zYCheck for plugin updates or notify the author before then. Details: hermes plugins compat) rxryr|rrPrrrrS)rrMnrlheadtailr\s rrr?s?   F A IIKF6<<>4JK KE$<$>#WAFS33Mi[Y,-Rw8d $< 5 !#WAFS33[\j[kkmnsmtu5i[@tu $< u %#WAFS34qAv27NNq!""QCt16Cr+B#eWNj $<rr}_seenloggingc ||f}|tvrytj|||k7r|d|n|d|}d|d|d|dtd }tj |t j |tdy) aPer-name record that a moved name was resolved through its old path: a ``HermesPluginCompatWarning`` (so ``-W error`` catches it in tests and plugin authors' CI) plus a WARNING log line (agent.log / gateway.log). The interactive CLI hides the warning category from stderr (:func:`quiet_for_interactive`) because its banner carries the user-facing message with the plugin NAME, which this call site cannot know.Nr:zhermes plugin compat: `z ` moved to `zD`. The old path is kept only for external plugins and is removed on z; update your import.) stacklevel)raddr_logwarningwarningswarnr)r9r; target_module target_namerdr'msgs r warn_oncerZs 4.C e| IIcN.9T.A]O1[M *-XYZ^Y_G`C $VHAdV<uE((6'77L NCLL MM#0Q?rc~tdtjDstjdtdyy)zCalled by the interactive CLI before plugin discovery: the banner notice replaces raw stderr warnings. Appends (does not override) so an explicit ``-W error::...HermesPluginCompatWarning`` still wins.c3bK|]'\}}}}}|dk(xr|duxrtt|)yw)errorN) issubclassr)rr_mc_mod_ls rrz(quiet_for_interactive..ms@;%1b!T2G|Z Z*=VXY2ZZ;s-/ignoreT)categoryrmN)anyrfiltersfilterwarningsrrrrquiet_for_interactiverjs8 ;)1)9)9; ;3LUYZ ;r)returnr)rDict[str, Dict[str, str]]r,)rMOptional[_dt.date]rbool)rMrrr$)rXrrzIterable[Path])r~r"rr"rrr List[Hit])rrrz Tuple[Tuple[str, int, int], ...])rOptional[Path]rr)rr)rr)rrrDict[str, List[Hit]])rrrNone)rr)rzOptional[dict]rr)rMrrz Optional[str])rrrMrrz List[str]) r9r"r;r"rr"rr"rr)rr)Ar __future__rrerrKr>rU threadingr dataclassesrpathlibrtypingrrrr r utilsr rLrNrrrr0rW FutureWarningrr!Lockr<r*r(r1rIrPrSr^rrrrrrrrrrrrrrrrr}r __import__ getLoggerrrrrrrrr(s$#  !88#chhtQ+$..0 & ' V K K $    !7;4;C2>D #*DZY^^  MO JO Dy~~ =? :?%25<+ +  *- =A`PT.Us)&&x0 @ [r