i@.dZddlZddlZddlZddlZddlmZddlmZddl m Z m Z m Z ddl mZejeZeZedz Zedz Zd efd Zd e eeffd Zd e eeffd Zdeded efdZded e e eeffdZdeded efdZded efdZd/ded efdZd/deded efdZ edkre!dedZ"e#e"d d!e#e"d"d#e"d$d%gZ$e"d&r'e$%e#e"d&d'e"d(r'e$%e#e"d(d)e!d*d+&e$d,e"d-d.dSdS)0u Skills Sync -- Manifest-based seeding and updating of bundled skills. Copies bundled skills from the repo's skills/ directory into ~/.hermes/skills/ and uses a manifest to track which skills have been synced and their origin hash. Manifest format (v2): each line is "skill_name:origin_hash" where origin_hash is the MD5 of the bundled skill at the time it was last synced to the user dir. Old v1 manifests (plain names without hashes) are auto-migrated. Update logic: - NEW skills (not in manifest): copied to user dir, origin hash recorded. - EXISTING skills (in manifest, present in user dir): * If user copy matches origin hash: user hasn't modified it → safe to update from bundled if bundled changed. New origin hash recorded. * If user copy differs from origin hash: user customized it → SKIP. - DELETED by user (in manifest, absent from user dir): respected, not re-added. - REMOVED from bundled (in manifest, gone from repo): cleaned from manifest. The manifest lives at ~/.hermes/skills/.bundled_manifest. N)Path)get_hermes_home)DictListTuple)atomic_replaceskillsz.bundled_manifestreturnctjd}|rt|Sttjjdz S)zLocate the bundled skills/ directory. Checks HERMES_BUNDLED_SKILLS env var first (set by Nix wrapper), then falls back to the relative path from this source file. HERMES_BUNDLED_SKILLSr )osgetenvr__file__parent) env_overrides 6/home/ubuntu/.hermes/hermes-agent/tools/skills_sync.py_get_bundled_dirr)sA 9455L"L!!! >> '( 22ctsiS i}tdD]e}|}|sd|vrC|d\}}}|||<`d||<f|S#t tf$ricYSwxYw)z Read the manifest as a dict of {skill_name: origin_hash}. Handles both v1 (plain names) and v2 (name:hash) formats. v1 entries get an empty hash string which triggers migration on next sync. utf-8encoding:) MANIFEST_FILEexists read_text splitlinesstrip partitionOSErrorIOError)resultlinename_hash_vals r_read_manifestr(5s    ! ! !++W+==HHJJ " "D::<z"_write_manifest..Ys4XXndH))x))XXXXXXrz.bundled_manifest_z.tmp)dirprefixsuffixwrrz&Failed to write skills manifest %s: %s)exc_info)tempfilerrmkdirjoinsorteditemsmkstempstrr fdopenwriteflushfsyncfilenor BaseExceptionunlinkr! Exceptionloggerdebug)r)r8datafdtmp_pathfes r_write_manifestrNPs OOOtd;;; 99XXw}}@W@WXXX X X[_ _D`''M())'(  H 2sW555 %  $$$ % % % % % % % % % % % % % % % 8] 3 3 3 3 3     (####        ``` =}aZ^ _________`ss(2E%D02AD D0DD0DD00 E";EE" EE"EE""E%% F/#FFskill_mdfallbackc |dddd}n#t$r|cYSwxYwd}|dD]}|}|dkr|rnbd }#|r\|d rG|d d d d }|r|cS|S)zORead the name field from SKILL.md YAML frontmatter, falling back to *fallback*.rreplace)rerrorsNiFr.z---Tzname:rz"')rr!splitr startswith)rOrPcontentin_frontmatterr$strippedvalues r_read_skill_namer[qs$$gi$HH$O N d##  ::<< u   !N   h11':: NN3**1-3355;;EBBE  Os " 11 bundled_dircg}|s|S|dD]Q}t|}d|vsd|vsd|vr|j}t ||j}|||fR|S)zz Find all SKILL.md files in the bundled directory. Returns list of (skill_name, skill_directory_path) tuples. zSKILL.mdz/.git/z /.github/z/.hub/)rrglobr>rr[r%append)r\r rOpath_str skill_dir skill_names r_discover_bundled_skillsrcs F      %%j11//x== x  ;(#:#:h(>R>R O %h ??  z9-.... Mrrac@||}t|z S)z Compute the destination path in SKILLS_DIR preserving the category structure. e.g., bundled/skills/mlops/axolotl -> ~/.hermes/skills/mlops/axolotl ) relative_to SKILLS_DIR)rar\rels r_compute_relative_destrhs"    , ,C  r directoryctj} t|dD]}|rq||}|t|d|| n#ttf$rYnwxYw| S)zHCompute a hash of all file contents in a directory for change detection.*r) hashlibmd5r;r^is_filereupdater>encode read_bytesr!r" hexdigest)rihasherfpathrgs r _dir_hashrus []]F IOOC0011 2 2E}} 2'' 22 c#hhoog66777 e..00111  2 W          sB*CCCFquietct}|s ggdggddStddt }t |}d|D}g}g}g}d}|D]\} } t | |} t| } | |vr | r7|dz }t| | kr| || <nx|std| d| d n_| j ddtj | | | | | || <|std | #ttf$r"} |std | d | Yd } ~ d } ~ wwxYw| r|| d}t| }|s||| <|| kr|dz }n|dz }_||kr,| | |std| d| |krF | d}tjt%| t%| tj | | | || <| | |std| dtj|dnm#ttf$rY|rC| s/tjt%|t%| wxYw#ttf$r"} |std| d | Yd } ~ d } ~ wwxYw|dz }|dz }t)t+||z }|D]}||=|dD]}||}t|z }|sm |j ddtj||h#ttf$r&} t4d|| Yd } ~ d } ~ wwxYwt9||||||t;|dS)z Sync bundled skills into ~/.hermes/skills/ using the manifest. Returns: dict with keys: copied (list), updated (list), skipped (int), user_modified (list), cleaned (list), total_bundled (int) r)copiedupdatedskipped user_modifiedcleaned total_bundledTr+ch|]\}}|Sr0r0)r1r%r&s r zsync_skills..s888gdAT888rrTu ⚠ uw: 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 : Nrz ~ z (user-modified, skipping)z.baku ↑ z (updated)) ignore_errorsz ! Failed to update zDESCRIPTION.mdzCould not copy %s: %s)rrrfr9r(rcrhruprintrshutilcopytreer_r!r"get with_suffixmover>rmtreer;setkeysr^recopy2rGrHrNlen)rvr\manifestbundled_skills bundled_namesrxryr{rzrb skill_srcdest bundled_hashrM origin_hash user_hashbackupr|r%desc_mdrg dest_descs r sync_skillsrs#$$K      RAB   TD111H-k::N88888M FGMG!/YY I%i== ++ X % % C;;==3qLG ,66/;,,"GZGGBLGGGK%%dT%BBBOIt444MM*---+7HZ( 31Z11222W% C C CCA AAaAABBB C [[]]2 ",,z266K!$I (1$ ,,qLGGqLGK''$$Z000IGGGGHHH{**I!--f55FKD 3v;;777  4888/;,z222$C!"A:"A"A"ABBB fDAAAAA#W-!==??@4;;==@"KF SYY??? B  )III IGjGGAGGHHHI1  qLGGS))M9::G TNN$$%566BB!!+..$ !! B B &&td&CCC Wi0000W% B B B 4gqAAAAAAAA B  BH&^,,   sd%B*EF!E>>FAL#AJ43L#4A*LL##M4MM+1PQ.QQr%restorec 6t}t}t|}d|D}||v}||v}|s |s ddd|dddS|r||=t|d}|r}|s ddd|d ddSt |||} | rF t j| d }n.#ttf$r} dd d |d | d| ddcYd} ~ Sd} ~ wwxYwtd } |r |r d} d|d} n|r d} d|d} nd } d |d} d | | | dS)u; Reset a bundled skill's manifest tracking so future syncs work normally. When a user edits a bundled skill, subsequent syncs mark it as ``user_modified`` and skip it forever — even if the user later copies the bundled version back into place, because the manifest still holds the *old* origin hash. This function breaks that loop. Args: name: The skill name (matches the manifest key / skill frontmatter name). restore: If True, also delete the user's copy in SKILLS_DIR and let the next sync re-copy the current bundled version. If False (default), only clear the manifest entry — the user's current copy is preserved but future updates work again. Returns: dict with keys: - ok: bool, whether the reset succeeded - action: one of "manifest_cleared", "restored", "not_in_manifest", "bundled_missing" - message: human-readable description - synced: dict from sync_skills() if a sync was triggered, else None ci|]\}}|| Sr0r0)r1rbras r z'reset_bundled_skill..\sYYY1FYz9YYYrFnot_in_manifest'zi' is not a tracked bundled skill. Nothing to reset. (Hub-installed skills use `hermes skills uninstall`.)N)okactionmessagesyncedbundled_missingup' has no bundled source — manifest entry cleared but cannot restore from bundled (skill was removed upstream).Tmanifest_clearedzCleared manifest entry for 'z$' but could not delete user copy at rrvrestoredz Restored 'z' from bundled source.z/' (no prior user copy, re-copied from bundled).zf'. Future `hermes update` runs will re-baseline against your current copy and accept upstream changes.) r(rrcrNrhrrrr!r"r)r%rrr\rbundled_by_name in_manifest is_bundleddeleted_user_copyrrMrrrs rreset_bundled_skillrAsR0H"$$K-k::NYY.YYYO("K(J   z  'IDIII   " TN!!! +UUUU &od&;[II ;;==   d###$(!!W%   0;t;;/3;;78;;# t $ $ $F  $  ;t;;;   TtTTT# W4 W W W  &W O OOsB66C!CC!C!__main__z1Syncing bundled skills into ~/.hermes/skills/ ...rrxz newryz updatedrzz unchangedr{z user-modified (kept)r|z cleaned from manifestz Done: z, z. r}z total bundled.)F)'__doc__rlloggingr rpathlibrhermes_constantsrtypingrrrutilsr getLogger__name__rG HERMES_HOMErfrrr>r(rNr[rcrhrubooldictrrrr#rpartsr_r:r0rrrsk, ,,,,,,$$$$$$$$$$  8 $ $o 8 # 00  3$ 3 3 3 3S#X6`T#s(^````Btss*$4c4i8H3I(d$  #    MMtMMMMM`_P_Pc_PD_PT_P_P_P_PD z E =>>> [u % % %F 3vh &&& 3vi ! !+++ ) ((( E oM F?344KKKLLL iH F9-..FFFGGG E QTYYu%% Q Q)@ Q Q QRRRRRr