ei@"dZddlZddlZddlZddlZddlmZddlmZddl m Z m Z m Z ej eZeZedz Zedz Zdefd Zde eeffd Zd e eeffd Zd ededefdZdede e eeffdZdededefdZdedefdZd.dedefdZd.dededefdZedkrededZ e!e dd e!e d!d"e d#d$gZ"e d%r'e"#e!e d%d&e d'r'e"#e!e d'd(ed)d*$e"d+e d,d-dSdS)/u 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)DictListTupleskillsz.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 3/home/div/.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'4s    ! ! !++W+==HHJJ " "D::<z"_write_manifest..Xs4XXndH))x))XXXXXXrz.bundled_manifest_z.tmp)dirprefixsuffixwrrz&Failed to write skills manifest %s: %s)exc_info)tempfilerrmkdirjoinsorteditemsmkstempstrr fdopenwriteflushfsyncfilenoreplace BaseExceptionunlinkr Exceptionloggerdebug)r(r7datafdtmp_pathfes r_write_manifestrNOs OOOtd;;; 99XXw}}@W@WXXX X X[_ _D`''M())'(  H 2sW555 %  $$$ % % % % % % % % % % % % % % % Jx / / / / /     (####        ``` =}aZ^ _________`ss(2E*D52AD D5DD5DD55 E'EE' E"E'!E""E''E** F"4#FF"skill_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*.rrC)rerrorsNiFr-z---Tzname:rz"')rr splitr startswith)rOrPcontentin_frontmatterr#strippedvalues r_read_skill_namerZps$$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=rrZr$append)r[rrOpath_str skill_dir skill_names r_discover_bundled_skillsrbs F      %%j11//x== x  ;(#:#:h(>R>R O %h ??  z9-.... Mrr`c@||}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)r`r[rels r_compute_relative_destrgs"    , ,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_filerdupdater=encode read_bytesr r! hexdigest)rhhasherfpathrfs r _dir_hashrts []]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|]\}}|Sr/r/)r0r$r%s r zsync_skills..s888gdAT888rrSu ⚠ 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)rrrer8r'rbrgrtprintrshutilcopytreer^r r!get with_suffixmover=rmtreer:setkeysr]rdcopy2rGrHrNlen)rur[manifestbundled_skills bundled_namesrwrxrzryra skill_srcdest bundled_hashrM origin_hash user_hashbackupr{r$desc_mdrf 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|]\}}|| Sr/r/)r0rar`s 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 rrurestoredz 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'rrbrNrgrrrr r!r)r$rrr[rbundled_by_name in_manifest is_bundleddeleted_user_copyrrMrrrs rreset_bundled_skillr@sR0H"$$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/ ...rrwz newrxz updatedryz unchangedrzz user-modified (kept)r{z cleaned from manifestz Done: z, z. r|z total bundled.)F)%__doc__rkloggingr rpathlibrhermes_constantsrtypingrrr getLogger__name__rG HERMES_HOMErerrr=r'rNrZrbrgrtbooldictrrrr"rpartsr^r9r/rrrsY, ,,,,,,$$$$$$$$$$  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