+ lHj["Rt^RIt^RIt^RIt^RIt^RIt^RIt^RIHt^RI H t H t ^RI H t ^RIHtHtHtHtHtHt]P*]P,3FAt]!]R4'gK]!]]4;_uu_4]P7RRR 7RRR4KC ^R IHtHtHt^R I H!t!H"t"^R I#H$t$^R I%H&t&H't'H(t(H)t)^RI*H+t+]PX!]-4t.]!4t/]/R, t0]0R, t1]/t2]0t3]1t4RRlt5RRlt6RRlt7RRlt8Rt9RRlt:RRlt;RRltR%R&lt?R'R(lt@R)R*ltAR+R,ltBR-R.ltCR/R0ltDR1R /R2R3lltERgR4R5lltFR6R7ltGR8R9ltHR:R;ltI] !R<R=44tJR>R?ltKR@RAltLRBRCltMRDREltNRFRGltORHRIltPRfRJRKlltQRLRMltR]-RN8XEd7]S!RO4]Q!R RP7tT]U!]TRQ,4 RR2]U!]TRS,4 RT2]TRU, RV2.tV]TRW,;tW'd\RXP]WRY,4]U!]W4^8dRZ]U!]W4^, R[2MR\,tY]VP]U!]W4 R]]Y 24]TR^,'d"]VP]U!]TR^,4 R_24]TPR`4;t\'d]VP]U!]\4 Ra24]S!RbRXP]V4 Rc]TRd, Re24R#R# +'giEK;i)ha<Skills Sync -- manifest-based seeding and updating of bundled skills. Copies repo skills/ into ~/.hermes/skills/, tracking each synced skill's origin hash in .bundled_manifest (v2 "name:hash" lines; v1 plain names auto-migrate). NEW skills are copied and recorded; EXISTING skills update only when bundled changed AND the user copy still matches the origin hash (else user-customized -> SKIP); user-DELETED skills are not re-added; upstream-REMOVED ones leave the manifest once no active or archived copy remains (the entry is that copy's only built-in provenance record).N)suppress) dataclassfieldPath)DictIteratorListOptionalSetTuple reconfigureutf-8replace)encodingerrors)get_bundled_skills_dirget_hermes_homeget_optional_skills_dir)ESSENTIAL_SKILLSis_excluded_skill_path)read_skill_name)_backfill_optional_provenance_ignore_runtime_cache_is_runtime_cache_read_hub_install_paths)atomic_write_textskills.bundled_manifestc0V^8dQhR\R\/#) at_importreturnr)formats"6/home/ubuntu/.hermes/hermes-agent/tools/skills_sync.py __annotate__r%5sMMMDMcF\V4V8wd \V4#V!4#)zJThe patched module global if it changed since import, else the live value.r) configuredr!fallbacks&&&r$_liver*5s #J/9<4 L(*Lr&c$V^8dQhR\/#r r"r)r#s"r$r%r%:sGGdGr&c4\\\\4#N)r* HERMES_HOME_HERMES_HOME_AT_IMPORTrr&r$ _hermes_homer2:s 4o FFr&c$V^8dQhR\/#r,r)r#s"r$r%r%>sWWTWr&c.\\\R4#)c$\4R, #r)r2r1r&r$_skills_dir..?s LNXs 24U VVr&c$V^8dQhR\/#r,r)r#s"r$r%r%Bsgggr&c.\\\R4#)c$\4R, #)r)r;r1r&r$r7 _manifest_file..Cs +-ReBer&)r* MANIFEST_FILE_MANIFEST_FILE_AT_IMPORTr1r&r$_manifest_filerBBs  8:e ffr&z.no-bundled-skillsc$V^8dQhR\/#r,r)r#s"r$r%r%KsKK$Kr&ch\\\4PPR, 4#r6)rr__file__parentr1r&r$_get_bundled_dirrGKs" !$x."7"7">">"I JJr&c$V^8dQhR\/#r,r)r#s"r$r%r%OsUU4Ur&ch\\\4PPR, 4#)zoptional-skills)rrrErFr1r&r$_get_optional_dirrJOs# "4>#8#8#?#?BS#S TTr&c0V^8dQhR\R\/#)r pathr")rstr)r#s"r$r%r%Ss66D6S6r&cPVP\44P4#r.) relative_tor;as_posix)rLs&r$_rel_skills_posixrQSs   KM * 3 3 55r&FcRV^8dQhR\R\R\\,/#)r rootsortr")rboolr)r#s"r$r%r%Ws%$dx~r&c#"VP4'dVPR4M \R4pV'd \V4MTFp\ V4'dKVxK R#5i)zRYield every non-excluded SKILL.md under ``root`` (nothing when it does not exist).SKILL.mdNr1)existsrglobitersortedr)rSrTfoundskill_mds&& r$_iter_skill_mdsr^WsH&*kkmmDJJz "bE%)F5Mu4%h//N5s:A*A* A*cFV^8dQhR\R\\,/#)r rTr")rUrr)r#s"r$r%r%_s000(4.0r&c*\\4V4#)z"_write_manifest..s H0G!AaS|0Gsz.bundled_manifest_T) tmp_prefix preserve_modez&Failed to write skills manifest %s: %sexc_infoN) hermes_constantsrrBrFjoinr[itemsrrloggerdebug)rrdataes& r$_write_manifestrs}8N,334cwwHw}}0GHH.*D=Qaef c =~?OQR]a bbcsAA** B!5!BB!chV^8dQhR\R\\\\3,,/#)r bundled_dirr")rlisttuplerM)r#s"r$r%r%s, V V$ V4c4i8H3I Vr&cVP4'g.#VPR4Uu.uFRp\VPV4VR7'dK'\ WP P 4VP 3NKT up#uupi)z``(skill_name, skill_dir)`` per SKILL.md under the bundled dir. Exclusions are evaluated relative to the bundled tree: the install prefix itself may contain ``venv``/``site-packages`` (which once made wheel installs discover zero skills).rW)rS)rXrYrrOrrFrj)rmds& r$_discover_bundled_skillsrs|      ##J/ V/B%bnn[&A TT 9YY^^ ,bii8/ VV Vs $B/Bc<V^8dQhR\R\R\/#)r skill_dirrr"r)r#s"r$r%r%s!>>d>>$>r&cB\4VPV4, #)zZDestination preserving category structure (bundled/mlops/axolotl -> skills/mlops/axolotl).)r;rO)rrs&&r$_compute_relative_destrs =900= ==r&include_runtime_cachec<V^8dQhR\R\R\/#)r directoryrr")rrUrM)r#s"r$r%r%s!     r&c &\P!4p\\4;_uu_4\ VP R44FpV'g\ W04'dKVP4'gK6VP\VPV44PR44VPVP44K RRR4VP4# +'giTP4#;i)zMD5 of package paths/content, excluding generated runtime state. The legacy option is only for proving an exact pre-filter origin match. Keep the original path encoding so clean existing manifests remain valid. *rN)hashlibmd5rrzr[rYris_filerirMrOencode read_bytes hexdigest)rrhasherfpaths&$ r$dir_hashrs [[]F '  IOOC01E%->u-P-PV[VcVcVeVe c%"3"3I">?FFwOP e..012           s4C1&C1>AC11 D c^V^8dQhR\R\R\\,R\/#)r r origin_hash user_hashr")rrMr rU)r#s"r$r%r%s4 d dD ds dxPS} d`d dr&cpV'gR#Vf \V4MTpW18H;'g\VRR7V8H#)aProve unchanged package ownership against a clean OR exact legacy hash. Never re-baseline a differing package merely because it contains a cache: if legacy cached bytes changed/disappeared, the old origin cannot be proven. A genuinely edited package must remain protected in that case. FT)r)r)rrrcurrents&&& r$_matches_origin_hashrs9 %.%6hy!IG  ! c cXit%TXc%ccr&c4V^8dQhR\R\RR/#r srcdestr"Nr)r#s"r$r%r%s!%%4%t%%r&cVPPRRR7\P!\ V4\ V44R#)Tparentsexist_okN)rFmkdirshutilmoverMrrs&&r$ _move_dirrs/KKdT2 KKC#d)$r&c4V^8dQhR\R\RR/#rr)r#s"r$r%r%s!==4=t==r&cxVPPRRR7\P!W\R7R#)TrignoreN)rFrrcopytreerrs&&r$ _copy_dirrs(KKdT2 OOC&; %sTrz)Relocated renamed bundled skill: %s -> %su → z (moved u → ))manifestget active_indexra setdefaultrrFrjappendr hub_pathsis_dirrQ ValueErrorrsayrrzrwarninginfo)rrrrr candidaterels&&& r$_recover_renamed_skillrs++//*b1K  (*B OO & &r99>>'JB O V VWYW`W` a+.0 __((R8  I$4$4$6$6  #I.C ,,  #I;; FF $CDUVZD[C\]$$'5),,6<7_a b   i &  ?Q  |8C56G6M5NaPQ -9. %     NNF bfN g s$, F F# F F ##G  G ca]tRtRtoRt^t]!]R7t]!]R7t ]!]R7t ]!]R7t ]!]R7t ]!]R7t Rt]!]R7tV3RlRltV3RltRtVtR#) riz;Mutable accumulator threaded through one sync_skills() run.)default_factoryNc$<V^8dQhRS[RR/#)r msgr"N)rM)r# __classdict__s"r$r%_SyncState.__annotate__sstr&cDVP'g\V4R#R#r.)quietprint)selfrs&&r$r_SyncState.sayszzz #Jr&cZ<V^8dQh/S[S[S[3,;R&S[;R&S[;R&S[S[,;R&S[S[,;R&S[S[,;R&S[S[,;R&S[S[,;R&S[S[,;R &S[S[S[S[S[,3,,;R &S[S[,;R &#) r rrskippedcopiedupdated user_modified suppressed relocatedshadowed_by_externalrr)rqrMrUintrr rrc)r#rs"r$r%rs38n K    I3 #Y49:S 7Cy6s)A4T$Z0183x4r&r1)__name__ __module__ __qualname____firstlineno____doc__rrrrrrrrrrrcrr__annotate_func____static_attributes____classdictcell__)rs@r$rrslEGd3Ft4G$T:M!$7J 6I&+D&A48L4Ir&rc(V^8dQhR\RR/#)r rr"Nr)r#s"r$r%r%s ` ` `$ `r&c VPR4pVP4'd=VP4'g%\W4\P RV4R#R#R# \ d\P RTRR7R#i;i)zIf an interrupted update left the user's only copy in ``dest.bak`` with dest gone, move it back so the skill isn't misread as user-deleted..bakz#Recovered orphaned skill backup: %sz*Could not recover orphaned skill backup %sTrN) with_suffixrXrrrrzr)rorphans& r$_recover_orphan_backupr st  f %F }}t{{}} ` f # KK=v F - ` NNGZ^N _ `s!A&&#B  B c LV^8dQhR\R\R\R\RR/#)r rrr bundled_hashr"NrrMr)r#s"r$r%r%'s1 * *: *3 *d *RU *Z^ *r&cbVPPV4V;P^, unVPRV R24VP 4'dP\ V4V8Xd>\ V4VPRV 24VPPVR4R#R#R#)zAn external_dirs source provides this skill; a local copy would be a name collision the loader refuses. Defer for ALL manifest states; remove a stale local shadow from an earlier sync only when byte-identical (a user's own skill differs).u ⇢ z7 (deferred to external_dirs, not written to local tree)u ✓ removed stale shadow of N) rrrrrXr_rmtree_writablerpop)rrrr s&&&&r$_defer_to_externalr's"":.JJ!OJFFVJ<V WX {{}}$<7 / |<=  D)8}r&c XV^8dQhR\R\R\R\R\RR/#r rr skill_srcrr r"Nr )r#s"r$r%r%4s888:83848t8cf8ko8r&cVP4'dTV;P^, un\V4V8XdW@PV&R#VP RV RV R24R#\ W#4VP PV4W@PV&VP RV 24R# \d#pTP RT RT 24Rp?R#Rp?ii;i)z6Handle a skill never offered before (not in manifest).ruw: bundled version shipped but you already have a local skill by this name — yours was kept. Run `hermes skills reset z)` to replace it with the bundled version.z + z ! Failed to copy : N) rXrrrrrrrrz)rrrrr rs&&&&& r$_install_new_skillr4s8 ;;== JJ!OJ~-*6 J'ZL)QQ[P\];<= i & II  Z (&2KK # FFT*& ' 8 $ZL1#6778s)B57B5B5+AB55 C"CC"c4V^8dQhR\R\RR/#)r rrr"Nr)r#s"r$r%r%Ks&JJ$JdJtJr&cVPR4pVP4'd \V4\P!\ V4\ V44\P !W\R7\T4R# \dTP4'dTP4'd7\T4M) \d\PRTRR7Mi;iTP4'g*\P!\ T4\ T44hi;i \d\PRTRR7R#i;i)z[Replace ``dest`` with a fresh copy of ``skill_src`` via a .bak sibling; restore on failure.rrz.Could not clear partial copy %s during restoreTrzCould not remove backup %sN) rrXrrrrMrrrzrrr)rrbackups&& r$_replace_skill_dirrKs   f %F }}  KKD 3v;'  0EFJ    ==??{{}}2$T*2NN#SUY,0#22;;== CKT3   J 16D IJsNB: D8 D5(D5? C  D5 #C1.D50C11D5 +D58#EEc XV^8dQhR\R\R\R\R\RR/#rr )r#s"r$r%r%ds9,,z,s,t,SW,gj,os,r&cVPPVR4pV'd"WE8XdV;P^, unR#\V4pV'g*W`PV&V;P^, unR#\ W5V4'g3VP P V4VPRV R24R#\W#4Y@PT&TPP T4TPRT R24R# \d#pTPRT RT 24Rp?R#Rp?ii;i) z3Handle a skill that is in the manifest AND on disk.rgNz ~ z (user-modified, skipping)z ! Failed to update ru ↑ z (updated)) rrrrrrrrrrzr)rrrrr rrrs&&&&& r$_update_existing_skillrds++//*b1K|2 a I "+ J a  9 = =  + j\!;<=9++KK JJj!FFVJ >T >hs4y>Q >VZ >r&cVPR4Fp\4VPV4, pVeVPV9gVP 4'dKPVPP RRR7\ P!W#4K R# \d"p\PRY$4Rp?KRp?ii;i)zCopy category DESCRIPTION.md files not already present; ``only_dirs`` restricts seeding to the essential skills' categories on opted-out profiles.zDESCRIPTION.mdNTrzCould not copy %s: %s) rYr;rOrFrXrrcopy2rzrr)rrdesc_md dest_descrs&& r$_seed_category_descriptionsr$~s$$%56MG$7$7 $DD  !i&6&6i&GIL\L\L^L^  >    " "4$ " ? LL , 7 > LL0' = = >s#3B C'CCc0V^8dQhR\R\/#)r rr")rUrq)r#s"r$r%r%s=+=+t=+=+r&cH\4\, P4pV'dV'g \R4\ 4pVP4'gR.R.R^R.R.R.R^R ./#\ 4P R R R 7\V4pV'd$VUUu.uFwrEV\9gKWE3NK ppp\4p\4p\\4VR 7pVEFwrW9d)V \9dVPPV 4K4\W4p \!V 4p \#V 4V P4'g>WP$9d.\'WV 4'dVP(PV 4W9d\+WW4KWP$9d\-WWV 4KV P4'd\/WWV 4EKV;P0^, unEK V'd.M8\3\5VP$4VUU u0uFwrMVkK up p, 4p\54pV'd\ 4R , p\74Uu0uF#p\9VVP:P<4kK% upVP?4'dCVPA4Uu0uF'pVP?4'gKVP<kK) upM \54,pVUu.uF qDV9gK VNK ppVFpVP$VK \CTV'd*VU Uu0uFwr\WR4P:kK upp MR4\EVP$4RVPFRVPHRVP0RVPJRVRVPRVP(R\MV4R \OVR7RVPPRV/ #uuppiuup piuupiuupiuupiuupp i)zSync bundled skills into ~/.hermes/skills/ using the manifest; returns the per-category result dict. Opted-out profiles seed ONLY ESSENTIAL_SKILLS (the system prompt always points at ``hermes-agent``).u` (profile opted out of bundled skills via .no-bundled-skills — seeding essential skills only)rrrrcleanedr total_bundledoptional_provenance_backfilledTr)rrz.archiveNrrrskipped_opt_out))r2NO_BUNDLED_SKILLS_MARKERrXrrGr;rrrrrnrrrrrrr rrrrrrrr[rcrarrFrjriterdirr$rrrrlenrr)ressential_onlyrbundled_skillsrjrrexternal_indexrrrrr r}removedpresentarchiverpr's& r$ sync_skillsr6sJ#n'??GGINe pq"$K     "iY?BPY[]b/16VXZ\ \Mt4-k:N7Eb~)$QaIa+4+~b')J02N ^-U ;B!/  # :J(J MM  , %i= * t${{}}{{!:?UVXfj?k?k LL   +  ' rt B {{ * ry M [[]] "29L Q JJ!OJJ%"0.#bs2;;/?WeBfWeGD4WeBf/f(gGeG-*,AWAYZAY2?2ryy~~6AYZAHAQAQW__. =.!((*VQVV. =WZW\^ '?w+>ttG? KK Zh~V~VQ  1 8 8~VnrtBKK "))Y Irzz?\^\l\l7L"--bll^,(*Ge*T 7 7>  ++Sc8Cg[ =? Ws6$P8P4 P >)PP.PP"P P c(V^8dQhR\RR/#)r rLr"Nr)r#s"r$r%r%s++4+D+r&c\V4P4p\4P4pW!P9d\ RV: RV: R24hRp\ P !WR7R#)a`rmtree that first makes read-only entries writable (Nix/deb/rpm keep r-x dirs; unlinking a child needs a writable parent, so chmod both). Scope guard: refuses anything not a STRICT child of the active skills root (bad join / missing HERMES_HOME / malicious manifest entry). Handles immutable package sources (Nix store, deb/rpm installs) that preserve read-only permissions on copied files *and* directories (``r-xr-xr-x``). Removing a child requires write permission on its parent directory, so the retry handler makes the failing path **and its parent** writable before re-attempting. See #34860, #34972. zrefusing to rmtree z: not strictly under u (scope guard — see #48200)c\PPV4V3FHp\\4;_uu_4\P !V\ P4RRR4KJ V!V4R# +'giKg;ir.)osrLdirnamerrzchmodstatS_IRWXU)funcrrr5s&&& r$ _on_error#_rmtree_writable.._on_errorsX''//%(%0A'""DLL)#"1 U #""s &A88 B )onerrorN)rresolver;rrrrmtree)rLtarget skills_rootr@s& r$rrs`$Z   !F-'')K..(.vj8Mk_\yz{{  MM$*r&__main__z1Syncing bundled skills into ~/.hermes/skills/ ...r*rz newrz updatedrz unchangedrz, :NNz, +z morergz user-modified (kept): r'z cleaned from manifestr)z official optional backfilledz Done: z. r(z total bundled.)Fr.)]rrloggingr:rr=sys contextlibr dataclassesrrpathlibrtypingrrr r r r stdoutstderr_streamhasattrr TypeErrorr rrrrrhrrrrtools.skills_sync_optionalrrrrutilsr getLoggerrrr/r9r@r0r:rAr*r2r;rBr,rGrJrQr^rarnrrrrrrrrrrrr rrrrr$r6rrr{r.partsrrshownrr backfilledr1r&r$rZsU (== CJJ'Gw && j) , ,     C- ,(^]F-$   8 $ 8 # 00 %"(M GWg 0KU60 (4c V> u  d% = #L  & ` *8.J2,4 >=+@+. z => u %FF8$%&d +F94E0F/Gx-PU[\eUfTggqRr sE''u' %)$s5zTU~#c%j1n-=U(C[]^ E |#:5'BC i F9-.//EFGZZ @AAzA J((EFG HTYYu%&b)@(A QRW- , ,s <K<< L