sjdZddlZddlZddlZddlZddlZddlZddlmZmZddl m Z m Z ej ej fD]4Zeedr& edd'#eef$rY0wxYw5dd lmZmZmZdd lmZdd lmZmZmZmZmZdd lm Z m!Z!ej"e#Z$eZ%e%d z Z&e&dz Z'e%Z(e&Z)e'Z*de fdZ+de fdZ,de fdZ-dZ.de fdZ/de fdZ0dee1fdZ2dee1e1ffdZ3de4fdZ5dee1e1ffdZ6de de1de1fdZ7de deee1e ffdZ8d e de de fd!Z9d"e de1fd#Z:d$e d%e de1fd&Z;d e dee1fd'Zd$e d*e de1fd+Z?d,d-d.e1d/e@deAfd0ZBdee1ee ffd1ZC dcd2e1d3eee1ee fdee fd4ZDddd5e@dee1fd6ZEdee1fd7ZFdee1ee ffd8ZGd9e1d:e1d;e dZHddd5e@deAfd?ZId$e ddfd@ZJddd.e1d/e@deAfdAZKd:e1dBe1de@fdCZLdeeAfdDZMd$e deeeNee1ffdEZOd.e1deAfdFZPdGe@deAfdHZQde@fdIZRdddJe@deAfdKZSe#dLkrWeTdMeId,NZUeVeUdOdPeVeUdQdReUdSdTgZWeUdUrneUdUZXdVZYdWZeXdeYZ[eVeXeYkre[dXeVeXeYz dYz Z[eW\eVeXdZe[eUd[r'eW\eVeUd[d\eU]d]r'eW\eVeUd]d^eTd_dWZeWd`eUdadbdSdS)eu= 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 bundled still matches origin hash: no update → skip without reading the user copy. * If bundled changed and user copy matches origin hash: safe to update. * If bundled changed and user copy differs: 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)datetimetimezone)Path PurePosixPath reconfigureutf-8replaceencodingerrors)get_bundled_skills_dirget_hermes_homeget_optional_skills_dir)is_excluded_skill_path)DictListOptionalSetTuple)atomic_replaceatomic_write_textskills.bundled_manifestreturnc`tt}|tkr|StS)z5Return the active profile's HERMES_HOME at call time.)r HERMES_HOME_HERMES_HOME_AT_IMPORTr configureds 5/home/agent/.hermes/hermes-agent/tools/skills_sync.py _hermes_homer!Ks-k""J+++   cftt}|tkr|Stdz S)z:Return the active profile's skills directory at call time.r)r SKILLS_DIR_SKILLS_DIR_AT_IMPORTr!rs r _skills_dirr&Ss0j!!J*** >>H $$r"cftt}|tkr|Stdz S)zAReturn the active profile's bundled-skills manifest at call time.r)r MANIFEST_FILE_MANIFEST_FILE_AT_IMPORTr&rs r _manifest_filer*[s1m$$J--- ==. ..r"z.no-bundled-skillsc^tttjjdz 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. r)r r__file__parentr"r _get_bundled_dirr/ls# "$x.."7">"I J JJr"c^tttjjdz S)z/Locate the official optional-skills/ directory.optional-skills)rrr,r-r.r"r _get_optional_dirr2us" "4>>#8#?BS#S T TTr"c ddlm}m}n#t$rt cYSwxYw|t }|D]r}|dD]Z}t |r|j}||j t|d}|r||[s|S)zIndex every skill available in external_dirs by name and frontmatter name. Returns a set of skill names that are already provided by external dirs. Used to prevent sync_skills from shadowing externally-delegated skills. r)get_external_skills_dirs_external_dirs_cache_clearSKILL.md) agent.skill_utilsr4r5 ImportErrorsetrglobrr-addname_read_skill_name)r4r5external_namesext_dirskill_md skill_dirfrontmatter_names r _build_external_skill_indexrDzs ZZZZZZZZZ uu    "uuN++-- 5 5 j11 5 5H%h//  I   y~ . . ./"==  5""#3444 5 s  &&ctsiS 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. rr :r7)r*exists read_text splitlinesstrip partitionOSErrorIOError)resultliner=_hash_vals r _read_manifestrSs    " " $ $ "$$...@@KKMM " "D::<z"_write_manifest..s4XXndH))x))XXXXXXr"z.bundled_manifest_) tmp_prefix preserve_modez&Failed to write skills manifest %s: %sexc_infoN) r*r-mkdirjoinsorteditemsrrXloggerdebug)r]dataes r _write_manifestrrs!!$!>>> 99XXw}}@W@WXXX X X[_ _Dc    +       ccc =~?O?OQR]a bbbbbbbbbcs+B C *CC rAfallbackc |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*.rr r NiFrbz---Tzname:rGz"')rIrMsplitrKrY)rArscontentin_frontmatterrPstrippedvalues r r>r>s$$gi$HH$O N d##  ::<< u   !N   h11':: NN3**1-3355;;EBBE  Os " 11 bundled_dircg}|s|S|dD]Z}t|||r'|j}t ||j}|||f[|S)zz Find all SKILL.md files in the bundled directory. Returns list of (skill_name, skill_directory_path) tuples. r6root)rHr;r relative_tor-r>r=append)r{rrArB skill_names r _discover_bundled_skillsrs F      %%j11 / / "   - -K     O %h ??  z9-.... Mr"rBcN||}t|z S)z Compute the destination path in the skills dir preserving the category structure. e.g., bundled/skills/mlops/axolotl -> ~/.hermes/skills/mlops/axolotl )rr&)rBr{rels r _compute_relative_destrs&    , ,C ==3 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) hashlibmd5rlr;is_filerupdatestrencode read_bytesrMrN hexdigest)rhasherfpathrs r _dir_hashrs []]F IOOC0011 2 2E}} 2'' 22 c#hhoog66777 e..00111  2 W          sB*CCCrZbasec@||}|}t|}d|jD}|s|rt d|Drt d|d|S)zLReturn a normalized relative POSIX path, rejecting traversal/absolute paths.cg|]}|dv| S)>r7.r.rdparts r z*_safe_rel_install_path..,s" B B BdD ,A,AT,A,A,Ar"c3"K|] }|dkV dS)z..Nr.rs r rez)_safe_rel_install_path..-s&-M-Mtddl-M-M-M-M-M-Mr"zUnsafe optional skill path: /)ras_posixrparts is_absoluteany ValueErrorrk)rZrrposixpurers r _safe_rel_install_pathr's   4 C LLNNE   D B Bdj B B BE AA#-M-Mu-M-M-M*M*MA???@@@ 88E??r"cg}t|dD]P}|r:|||Q|S)z8List files inside a skill directory in lock-file format.r)rlr;rrrr)rBfilesrs r _skill_file_listr2soE ,,--BB ==?? B LL**955>>@@ A A A Lr"cd ddlm}||S#t$rt|cYSwxYw)zJReturn the same hash style the skills hub lock uses, falling back locally.r) content_hash)tools.skills_guardrrXr)rrs r _content_hashr;sZ$333333|I&&& $$$#####$s //ct}i}|s|St|dD]v}t |||r'|j} t||}n#t$rYLwxYw|j }t||}|||f}|||<|||<w|S)a%Return official optional skills keyed by folder name and frontmatter name. Values are ``(folder_name, install_path, source_dir)``. Multiple keys may point to the same skill so callers can accept either the folder slug used by the hub lock or the user-facing frontmatter name. r6r}) r2rHrlr;rrr-rrr=r>) optional_dirindexrAsrc install_path folder_namerCrzs r _optional_skill_indexrGs%&&L.0E     <--j99::(( !   . .\     o 1#|DDLL    H h +HkBBlC0"k"' Ls8B  BB backup_rootcD|t}||z }|jdd|rd}||jd|r6|dz }||jd|6||jd|}tjt|t|| S)zLMove an existing skill directory into a restore backup, preserving rel path.Tr_ru-) rr&r-rjrH with_namer=shutilmoverr)rZrrtargetsuffixs r _move_to_restore_backuprds   ;== ) )C 3 F Mt444 }}=&+888899@@BB  aKF&+888899@@BB !!V[";";6";";<< KD 3v;;''' <<>>r"F)restorer=rcDt}|sddgggdS|dvr1tt|dng}|s%||}| dd|gggdS|g}g}g}t jtj d }td z d |z }|D]1\} } } tt| d z } t| } | ot| | k}t| d z | }g}trttd D]}t#|r|j} |tn#t($rYHwxYwt||j}|| krh|j| ks|| |hvr|||r|D]9}|r#|t/||:| r%|s#|t/| || sF| jddt3j| | || -|s13t7d}dd||||rt9|nddS)a3Restore one or all official optional skills from repo source. ``restore=False`` only performs exact-match provenance backfill. ``restore=True`` repairs already-mutated/reorganized skills by backing up matching active copies and copying the official optional source into its canonical path. Fz,No official optional skills directory found.)okmessagerestored backfilled backed_up>rallc|dS)Nrur.)items r z1restore_official_optional_skill..}s 47r"keyNz#Official optional skill not found: z %Y%m%d-%H%M%Sz.restore-backupszofficial-optional-rr6Tr_quietz(Official optional skill repair complete.r7)rrrrr backup_dir)rrlr:valuesgetrnowrutcstrftimer&rrvrrHr>r;rr-rrr=rrrjrcopytree_backfill_optional_provenancer)r=rrtargetsrrr timestamprrrrdestsrc_hash canonical_oksrc_frontmattermatchesrA candidatecandidate_namematchrs r restore_official_optional_skillrrs " # #E K(VdfvxHJKK KGK|G[G[fS((.B.BCCCCacG 4 >,XRV,X,XfhxzJLMM M(HI X\**33ODDI--"447WI7W7WWK*1##& \3}}t\%7%7%<%<==S>>{{}}D4H)D +3+;[II  ==   ! ! .";==#6#6z#B#BCC . .)(33$O ))+--8888!H!1(IN!K!K$$>[00N{TcFd4d4dNN9---    R R<<>>R$$%>>T*** ,,,   /T:::J= *3;c+&&&   s*!G  GGci}ts|StdD]}t|r|j} |tn#ttf$rYswxYw| |j g ||S)zCIndex installed skills by directory name with one active-tree scan.r6) r&rHr;rr-resolverrMr setdefaultr=r)rrArs r #_index_installed_skill_dirs_by_namers#%E ==   ! ! MM'' 33 ? ? !( + +  O        + +KMM,A,A,C,C D D D D$    H  ,,33I>>>> Ls AB&&B:9B:skill_dir_nameinstalled_indexc|r tsdS|t}||g}t |dkrdS|dS)uLocate an installed skill directory by its directory name. Used only as a fallback when the repo-derived install path doesn't exist in the active tree (upstream recategorized the skill after it was installed). Returns None when there is no match, or when the name is AMBIGUOUS — two skills sharing a directory name give us no basis to pick one, and guessing would write provenance onto the wrong skill. The caller still verifies a byte-identical content hash before recording anything. Nrur)r&rHrrlen)rrrs r !_find_installed_skill_dir_by_namersn !5!5!7!7t=??!!."55G 7||qt 1:r"rc `t}|sgStdz dz } |r(tj|dndid}n!#tjtf$rdid}YnwxYw|di}d| D}g}d }d }t| d D]} t| r| j } t| |} n3#t$r&} t d | | Yd } ~ Wd } ~ wwxYw| j} | |vs| |vrott'| d z }|r|sz|t-}t/| j|}| t|t} n4#t$r'} t d|| Yd } ~ 4d } ~ wwxYw| |vrBt1|t1| krdt3jt6j}dd| ddt=|| t?|ddi||d || <| | |!| d}|stEd| d|r,|j #dddd l$}tj%|dd dz}|&tO|j dd \}} tQj)|d!d5}|*||+tQj,|-d d d n #1swxYwYt]||n5#t^$r( tQj0|n#t$rYnwxYwwxYw|S)"aMark already-present official optional skills as hub-installed. This covers the migration case where a skill used to be bundled (or was manually copied into the active skills tree) and later lives under optional-skills/. If the active copy is byte-identical to the official optional source, record official hub provenance without copying or reinstalling anything. Modified/local skills are left alone. .hub lock.jsonrrFru)version installedrcbh|],}t|t|d-S)r) isinstancedictr)rdentrys r z0_backfill_optional_provenance..sD  eT " " .!!r"FNr6z/Skipping optional skill with unsafe path %s: %srz(Skipping relocated optional skill %s: %sofficialz official/builtinrbackfilled_fromr1) source identifier trust_level scan_verdictrrrmetadata installed_at updated_atTz = z* (official optional provenance backfilled)r_r)indent ensure_asciirbz.lock_z.tmp)dirprefixrw)1r2rHr&jsonloadsrIJSONDecodeErrorrMrrrlr;rr-rrrnror=rrvis_dirrrrrrrr isoformatrrr<rprintrjtempfiledumpsmkstemprosfdopenwriteflushfsyncfilenor BaseExceptionunlink)rr lock_pathrprexisting_pathsrchangedinstalled_dir_indexrArrrq lock_namerrrpayloadfdtmp_pathfs r rrs%&&L      &4I/DMDTDTDVDV{tz)--w-??@@@hixz\{\{  ' *///2../ R00I%%''N JG;?<--j99::6P6P !( + +  o 1#|DDLL    LLJCQR S S S HHHH H  ! !\^%C%C }}t\%7%7%<%<=={{}} DKKMM #*&I&K&K#4SX?RSSD| 5dKMMJJ     GqQQQ  > ) )  T??inn , , L..88::  4l44$()$//(%d++*,=>%# ) <((()$$$ P NNNN O O Otd;;; *T!%@@@4G''I$%%(  H 2sW555 %    $$$ % % % % % % % % % % % % % % % 8Y / / / /     (####        sAA<<BBD%% E/EE$H H2 H--H2*O9AO O9O!!O9$O!%O99 P+PP+ P&#P+%P&&P+cPtdz dz }|stS tj|d}n*#tjtf$rtcYSwxYwt}|dpi D]c}t|trL|d}|r5| t|dd|S)aqReturn install paths recorded in the skills-hub lock, as POSIX strings. Hub-installed skills are owned by the hub (``hermes skills uninstall``), never by bundled sync. Rename recovery must not move them even when their content happens to match a bundled origin hash, or the lock's ``install_path`` would point at a directory that no longer exists. rrrrFrrr)r&rHr:rrrIrrMrrrrr<rrK)rrppathsrrs r _read_hub_install_pathsrRs &4I     uu z)--w-??@@  ' *uu eeE((;''-2557788 eT " " 8 99^44L 8 #l++11#66777 Ls(A!!$BBc@i}ts|StdD]W}t|r|j}t ||j}||g|X|S)zIndex every skill in the user's tree by frontmatter name. Returns ``{skill_name: [skill_dir, ...]}``. Used by rename recovery to locate a bundled skill that upstream moved to a new category/directory. r6) r&rHr;rr-r>r=rr)rrArBr=s r _index_active_skillsrjs $&E ==   ! ! MM'' 3355 !( + +  O ).99 r"")))4444 Lr"r origin_hashr active_index hub_pathsc |sdS||gD]}||ks|s |t}n#t $rY_wxYw||vrht ||krP|sMtd|d|td|d|d  |j ddtj t|t|n7#ttf$r#td ||d YdSwxYwtd |||sJtd |d |d|td|cSdS)uIMove a bundled skill's stale copy to its new canonical path. When upstream RENAMES or RECATEGORIZES a bundled skill, the manifest key (frontmatter name) still matches but ``dest`` is a brand-new path that does not exist yet. Without recovery, ``sync_skills()`` falls through to its "in manifest but not on disk" branch and misreads the skill as *user-deleted*: the old directory is stranded forever and never receives another update. A stale copy is only moved when it is byte-identical to ``origin_hash`` — the hash recorded the last time sync wrote that skill — which proves the directory is the copy *we* placed there rather than the user's own work. Anything else (user-edited, hub-installed) is left untouched. Returns the relative source path when a move happened, else ``None``. N ⚠ z: upstream moved this skill to z, but your modified copy at uD was kept — it will not receive updates. Run `hermes skills reset z( --restore` to move to the new location.Tr_z)Could not relocate renamed skill %s -> %srhz)Relocated renamed bundled skill: %s -> %su → z (moved u → ))rrrr&rrrrr-rjrrrrMrNrnwarninginfo)rr rr!r"rrrs r _recover_renamed_skillr(|sD0 t!%%j"55##   I$4$4$6$6   '' 66??AACC    H  )    Y  ; . . 4Z44'' 66??AA44(+44:D444   K  dT  : : : KID 2 2 2 2!    NN;Y    444    ?DQQQ h f:ffsff9I9I+--9X9X9a9a9c9cfff g g g 4s$3A.. A;:A;'A D33/E'&E'c ttz r|stdggdggdgddSt }|s ggdgggdgdSt ddt}t|}d|D}t}t}g}d}d} g} g} g} g} g}d}|D]\}}||vr| | t||}t|}|d }|r|s |jddt!jt%|t%|t&d |n4#t*t,f$r t&d |d YnwxYw|so||vrk|t1}t3} t5|||d ||| p t9|}|r| |||vr| ||dz }|std|d|rLt||kr9t;||std|||d0||vr |r7|dz }t||kr|||<nx|std|d|dn_|jddt!j||| ||||<|std|#t*t,f$r"}|std|d|Yd}~d}~wwxYw|r||d }|r ||kr|dz }Qt|}|s|||<||kr|dz }n|dz }ztA||r,| ||std|d||kr |d }|rt;|t!jt%|t%| t!j|||||<| ||std|d t;|n4#t*t,f$r t&!d|d YnwxYwn#t*t,f$r|r|rE t;|n4#t*t,f$r t&d|d YnwxYw|s/t!jt%|t%|wxYwx#t*t,f$r"}|std|d|Yd}~d}~wwxYw|dz }|dz }tEt9|#|z }|D]}||=|$dD]}|%|}t |z }|sm |jddt!j&||o#t*t,f$r&}t&!d ||Yd}~d}~wwxYwtO|tQ|!}| | || || |tS|||d" S)#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) uJ (skipped — profile opted out of bundled skills via .no-bundled-skills)rT)copiedupdatedskipped user_modifiedcleaned total_bundledoptional_provenance_backfilledskipped_opt_out)r*r+r,r-r. suppressedr/r0r_ch|]\}}|Sr.r.)rdr=rQs r rzsync_skills..s888gdAT888r"Nz.bakz#Recovered orphaned skill backup: %sz*Could not recover orphaned skill backup %srhr7ruu ⇢ z7 (deferred to external_dirs, not written to local tree)u ✓ removed stale shadow of r$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 : z ~ z (user-modified, skipping)u ↑ z (updated)zCould not remove backup %sz.Could not clear partial copy %s during restorez ! Failed to update zDESCRIPTION.mdzCould not copy %s: %sr) r*r+r,r-r.r2 relocatedr/r0shadowed_by_external)*r!NO_BUNDLED_SKILLS_MARKERrHrr/r&rjrSrr\rDrrr with_suffixr-rrrrnr'rMrNr&rrr(rr:_rmtree_writablepopr_is_tracked_user_modificationrorlkeysr;rcopy2rrrr) rr{manifestbundled_skills bundled_namesr2external_indexr6r!r"r*r+r-suppressed_skippedr5r,r skill_srcr bundled_hash_orphan _moved_fromrqr  user_hashbackupr.r=desc_mdr dest_descr0s r sync_skillsrKs  1199;;  ` ^ _ _ _RAB.0T   #$$K      RABbST.0   MMt444H-k::N88888M'))J022N&(59L$(I FGM$&IG!/ I  # #  % %j 1 1 1 %i== ++ ""6** >>   DKKMM   !!$!>>> CLL#d))444 A7KKKKW%   @'! {{}} -x!7!7#355 355 0 Z,,"SUU K -  ,,,  ' ' ! ' ' 3 3 3 qLG 1Z111{{}} /4L!@!@ &&&IG:GGHHH Z...  X % % C;;==3qLG ,66/;,,"GZGGBLGGGK%%dT%BBBOIt444MM*---+7HZ( 31Z11222W% C C CCA AAaAABBB C [[]]P ",,z266K |{::1 !$I (1$ ,,qLGGqLG,[)DD $$Z000IGGGGHHH{**'I!--f55F }}1(000KD 3v;;777 4888/;,z222$C!"A:"A"A"ABBB^,V4444 '1^^^"LL)EvX\L]]]]]^#W-"==?? D#{{}}&!&$4T$:$:$:$:(/'9!&!&!&$*NN(X(,t%3%&%&%&%&%&!& $(;;==D & CKKT C C C  )III IGjGGAGGHHHI1  qLGGS))M9::G TNN$$%566BB!!+..MMC' !! B B &&td&CCC Wi0000W% B B B 4gqAAAAAAAA B  BH%B%O%O%O"&(^,,*H 4   s+A&G.HH#B*OP O==P,A'Y&AVU)(V).VVVVY&9Y!W('Y!(.XY!XAY!!Y&&Z7ZZ51]''^8^^ct|}t}||jvrt d|d|dddlfd}t j||dS)aRemove a directory tree, making read-only entries writable first. 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)rNctj||fD]-} tj|j#t $rY*wxYw||dSN)r rZdirnamechmodS_IRWXUrM)funcrrirstats r _on_errorz#_rmtree_writable.._on_errorstwu--u5  F ....     U sA A A)onerror)rrr&r`rrSrrmtree)rZr skills_rootrTrSs @r r9r9s($ZZ   ! !F--''))K&.(( ,& , , , , ,   KKK M$ ******r"c.t}t}t|}t|}||v}||v}|s |s ddd|dddSd}|rv|s ddd|dddSt |||} | r? t | d }n,#ttf$r} dd d | d | d ddcYd} ~ Sd} ~ wwxYw|r||=t|td } |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 the 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 Fnot_in_manifest'zi' is not a tracked bundled skill. Nothing to reset. (Hub-installed skills use `hermes skills uninstall`.)N)ractionrsyncedbundled_missingur' has no bundled source — manifest entry preserved but cannot restore from bundled (skill was removed upstream).T not_resetzCould not delete user copy at r4u3. Manifest entry preserved — nothing was changed.rrz Restored 'z' from bundled source.z/' (no prior user copy, re-copied from bundled).manifest_clearedzCleared manifest entry for 'zf'. Future `hermes update` runs will re-baseline against your current copy and accept upstream changes.) rSr/rrrrHr9rMrNrrrK)r=rr>r{r?bundled_by_name in_manifest is_bundleddeleted_user_copyrrqr\r[rs r reset_bundled_skillrdsG0H"$$K-k::N>**O("K(J   z  'IDIII    +UUUU &od&;[II ;;==   &&&$(!!W%   )MMMMMM# " TN!!!t $ $ $F  $  ;t;;;   TtTTT# W4 W W W  &W O OOsB C 1 C>C C rGc,t|o||kS)aWhether an on-disk skill counts as a user modification ``hermes update`` keeps. Shared by the sync loop (which decides what to skip) and ``list_user_modified_bundled_skills`` (which surfaces the names) so the two can never drift. A skill is a tracked modification only when it has a recorded origin hash (an un-baselined / v1 entry with an empty hash is not) and its current content hash differs from that origin. )bool)r rGs r r;r;fs    9k!99r"ct}|sgSt}g}t|D]y\}}||d}|st ||}|sCt |t|r||||dz| d|S)uReturn the bundled skills that ``hermes update`` keeps because the user edited them locally. A skill counts as user-modified when its on-disk copy no longer matches the origin hash recorded in the manifest the last time it was synced — the exact same test the sync loop uses to decide what to skip. This is the discovery half of that behavior, so a user can find the names the ``~ N user-modified (kept)`` notice only counts. Returns a list (sorted by name) of dicts: ``{"name": str, "dest": Path, "bundled_src": Path}`` where ``dest`` is the user's copy and ``bundled_src`` is the current stock copy (so callers can diff or restore). r7)r=r bundled_srcc|dS)Nr=r.)rqs r rz3list_user_modified_bundled_skills..s & r"r) rSr/rrrrHr;rrsort)r>r{modifiedrrBr rs r !list_user_modified_bundled_skillsrlrsH  "$$KH!9+!F!F   Ill:r22   %i=={{}}   (ioo F F  OO#T)LL    MM))M*** Or"c |}n#t$rYdSwxYwd|vr|dfS ||dfS#t$r|dfcYSwxYw)zRead a file once for diffing. Returns ``(raw_bytes, text)`` where ``text`` is ``None`` if the file is binary; ``(None, None)`` if it could not be read. Returning the raw bytes lets the caller compare binary files without re-reading them. NNNr)rrMdecodeUnicodeDecodeError)rZrps r _read_for_diffrrs   zz$TzT[[)))) Tzs %%AAAc Hddl}t}tt|}||}| d|ddgd|ddSt ||}|sd|ddgd|d |d dStt|}tt|}g}t||zD]} | |v} | |v} | rt|| z nd \} } | rt|| z nd \}}| r| r| | | |kr| | d d de| |krld | |d| dd| d| }| | d|d| r| | dd| d| | dd| dt|}d|d|||sd|dnd|dt!|ddS)u8Diff a user's copy of a bundled skill against the current stock version. Lets a user see exactly what diverged before deciding whether to keep their edits or ``hermes skills reset`` back to upstream. Returns a dict: ``ok`` (bool), ``name`` (str), ``found`` (bool — bundled source exists), ``modified`` (bool), ``message`` (str), ``diffs``: list of ``{"path": str, "status": str, "diff": str}`` where status is one of ``modified`` / ``added`` (only in user copy) / ``removed`` (only in bundled) / ``binary``. rNFrZzv' is not a tracked bundled skill (no stock version to diff against). Hub-installed skills use `hermes skills inspect`.)rr=foundrkdiffsrTzNo local copy of 'z ' found at rrnbinaryz)rZstatusdiffr7)keependszstock/zyours/)fromfiletofilerkaddedz+ only in your copy: removedz- only in stock: z' matches the stock version.z$' differs from the stock version in z file(s).)difflibr/rrrrrHr:rrlrrrrk unified_diffrJrfr)r=r~r{r`rhr user_files stock_filesrurin_userin_stock user_bytes user_text stock_bytes stock_texttextrks r diff_bundled_skillrs4NNN"$$K3K@@AAO!%%d++KTDTTT    "+{ ; ;D ;;== DDDDTDDD    %d++,,J&{3344KEj;.//%%#+%*1 CN4#: & & &|  I2: KN;, - - -| Z  x  J$6,,LL!$BYZZJ&&77$$))4)88(($(77+c^^)C>> %D LL#TJJ K K K K   LL9VQT9V9VWW     LL ;Ts;T;TUU    E{{H U 2 2 2 2 2TTTTs5zzTTT   r"enabledcttz }|} |rDtdd|dd| }|rdnd}n|r||}|rdnd }n1#t $r$}d d t|d |d |d cYd}~Sd}~wwxYwd|t||d S)ajToggle the .no-bundled-skills opt-out marker for the active profile. When ``enabled`` is True, writes HERMES_HOME/.no-bundled-skills so the installer, ``hermes update``, and any direct sync stop seeding bundled skills. When False, removes the marker so seeding resumes on the next sync. This is the on-disk-state half of ``hermes skills opt-out`` / ``opt-in``; removal of already-present skills is a separate, explicit step (see ``remove_pristine_bundled_skills``). Returns: dict with keys: ok (bool), changed (bool), marker (str path), message (str). Tr_zThis profile opted out of bundled-skill seeding (`hermes skills opt-out`). Delete this file to re-enable sync on the next `hermes update`. rrFzpOpted out of bundled skills. Future install / update / sync runs will not seed bundled skills into this profile.u1Already opted out — marker was already present.zgOpted back in. The next `hermes update` (or `hermes skills opt-in --sync`) will re-seed bundled skills.u&Not opted out — no marker to remove.Fz#Could not update opt-out marker at r4)rrmarkerrN)r!r7rHrj write_textrrMr)rrexistedrrrqs r set_bundled_skills_opt_outr s]^^6 6FmmooG   NN  = = =   T!     "kGIGGI G  G>??>     ES[[JVJJqJJ         7c&kkg V VVsA$B B?B:4B?:B?cRttz S)z=Return True if the active profile carries the opt-out marker.)r!r7rHr.r"r is_bundled_skills_opt_outr?s NN5 5 = = ? ??r"dry_runclt}t}tt|}g}g}t |D]\}}||}|||dd6t||} | s |s||vr||=dt| } | |kr||dd|r|| t| n9#ttf$r%} ||d| dYd} ~ d} ~ wwxYw||vr||=|||s|rt||rdnd} | dt|d t|d } d |||| d S) aDelete bundled skills that are present, manifest-tracked, AND unmodified. Safety is the whole point of this function. A skill on disk is removed ONLY when all of these hold: - it is recorded in the sync manifest (so it is genuinely a bundled skill, not a hub-installed or hand-written one), AND - it still exists in the bundled source (so we can hash-compare), AND - its on-disk copy is byte-identical to the manifest origin hash (so the user has not edited it). Anything user-modified, hub-installed, or locally authored is left untouched and reported under ``skipped``. The manifest entry for each removed skill is dropped so a later opt-in re-seed treats it as new. Args: dry_run: When True, compute what would be removed without deleting. Returns: dict with keys: ok (bool), removed (list[str]), skipped (list[dict]) where each dict is {name, reason}, dry_run (bool), message (str). Nz$no bundled source (removed upstream))r=reasonzuser-modified (kept)zdelete failed: z Would removeRemoved z! pristine bundled skill(s); kept rT)rr}r,rr)rSr/rrrlrmrrrrHrr9rMrNrrr)rr>r{r`r}r,r=r rron_diskrqverbrs r remove_pristine_bundled_skillsrDs#.H"$$K3K@@AAOGG#HNN$4$455k!!$'' ; NND4Z[[ \ \ \ %c;77{{}}  #tx//TN D// k ! ! NND4JKK L L L    NN4   T " " " "!    NND4Ia4I4IJJ K K K HHHH  8  t "w"!!!$ 3>>)DVVG VVs7||VVVGw7w  s DE*E  E__main__z1Syncing bundled skills into ~/.hermes/skills/ ...rr*z newr+z updatedr,z unchangedr-z, z, +z morez user-modified (kept): r.z cleaned from manifestr0z official optional backfilledz Done: z. r/z total bundled.rN)F)^__doc__rrloggingr rsysrrpathlibrrstdoutstderr_streamhasattrrr TypeErrorhermes_constantsr rrr8rtypingrrrrrutilsrr getLogger__name__rnrr$r(rr%r)r!r&r*r7r/r2rrDrSr:r\rrr>rrrrrrrrrfrrrrrrrr(rKr9rdr;rlbytesrrrrrrrrOrrr[MAX_SHOWrkshownrrr.r"r rs[ .  '''''''''''''''' CJ'Gww &&      C C C CI&    D  ^]]]]]]]]]4444443333333333333333333333  8 $ $o 8 # 00 %"(d%T%%%%/////0K$KKKKU4UUUU SX:S#X64cT#s(^cccc,tss*$4c4i8H3I2d$  #    Tcc $T $c $ $ $ $tCsC~)>$>?: $ T c    CHDDD#D4DDDDDDNT#tDz/-B(8<d3T ?34d^.mmm$s)mmmm`S0d3T ?3$??? ?sDJ' ? 3x ?  ?c]????DQQtQQQQQh.+4.+D.+.+.+.+b`P`Pc`PD`PT`P`P`P`PF :s :s :t : : : :"4:""""J%#(F"G&`S`T````F/W/W/W/W/W/Wd@4@@@@ CCDCTCCCCL z E =>>> [u % % %F 3vh &&& 3vi ! !+++ ) ((( E oD' %  *++ 3u:: 733u::0777 7E E BB5BBCCC iH F9-..FFFGGG zz233f F#CDEEdddeee E QTYYu%% Q Q)@ Q Q QRRRRR'sA  A*)A*