Pmj dZddlZddlZddlZddlZddlZddlZddlmZmZddl m Z m Z ej ej fD]4Zeedr& edd'#eef$rY0wxYw5dd lmZmZmZdd lmZdd lmZmZmZmZmZdd lm Z ej!e"Z#eZ$e$d z Z%e%dz Z&dZ'de fdZ(de fdZ)dee*fdZ+dee*e*ffdZ,de-fdZ.dee*e*ffdZ/de de*de*fdZ0de deee*e ffdZ1de de de fdZ2de de*fd Z3d!e d"e de*fd#Z4de dee*fd$Z5de de*fd%Z6dee*ee*e*e fffd&Z7d!e d'e de*fd(Z8d)d*d+e*d,e9de:fd-Z;dee*ee ffd.Z< d`d/e*d0eee*ee fdee fd1Z=dad2e9dee*fd3Z>dee*fd4Z?dee*ee ffd5Z@d6e*d7e*d8e d9ee*ee fd:ee*d2e9dee*fd;ZAdad2e9de:fd<ZBd!e ddfd=ZCdad+e*d,e9de:fd>ZDd7e*d?e*de9fd@ZEdee:fdAZFd!e deeeGee*ffdBZHd+e*de:fdCZIdDe9de:fdEZJde9fdFZKdadGe9de:fdHZLe"dIkrWeMdJeBd)KZNeOeNdLdMeOeNdNdOeNdPdQgZPeNdRrneNdRZQdSZRdTSeQdeRZTeOeQeRkreTdUeOeQeRz dVz ZTePUeOeQdWeTeNdXr'ePUeOeNdXdYeNVdZr'ePUeOeNdZd[eMd\dTSePd]eNd^d_dSdS)bu= 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_replaceskillsz.bundled_manifestz.no-bundled-skillsreturnc^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__parent7/home/thesage/.hermes/hermes-agent/tools/skills_sync.py_get_bundled_dirrFs# "$x.."7">"I J JJrc^tttjjdz S)z/Locate the official optional-skills/ directory.optional-skills)rrrrrrr_get_optional_dirr"Os" "4>>#8#?BS#S T TTrc 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_utilsr$r% ImportErrorsetrglobrraddname_read_skill_name)r$r%external_namesext_dirskill_md skill_dirfrontmatter_names r_build_external_skill_indexr4Ts 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 :r') MANIFEST_FILEexists read_text splitlinesstrip partitionOSErrorIOError)resultliner-_hash_vals r_read_manifestrDqs    ! ! !++W+==HHJJ " "D::<)rFpathnamesrAs r_read_suppressed_namesrNs ;;;;;;$$&&&    11{{}} 55LLL 88CCEE $ $zz||$ 4 4$IIdOOO $    D   s:6C CA+CC CCCCCentriesc@ddl}tjddddt |Ddz} |ttjdd \}} tj |d d 5}| || tj |dddn #1swxYwYt|tdS#t $r( tj|n#t$$rYnwxYwwxYw#t&$r.}t(d t|dYd}~dSd}~wwxYw)zWrite the manifest file atomically in v2 format (name:hash). Uses a temp file + os.replace() to avoid corruption if the process crashes or is interrupted mid-write. rNTparentsexist_ok c3*K|]\}}|d|VdS)r7Nr).0r-rCs r z"_write_manifest..s4XXndH))x))XXXXXXrz.bundled_manifest_.tmpdirprefixsuffixwrr6z&Failed to write skills manifest %s: %sexc_info)tempfiler8rmkdirjoinsorteditemsmkstempstrosfdopenwriteflushfsyncfilenor BaseExceptionunlinkr>rIloggerdebug)rOr`datafdtmp_pathfes r_write_manifestrvs 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/#FFr1fallbackc |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 NiFrTz---Tzname:r7z"')r:r>splitr<rK)r1rwcontentin_frontmatterrAstrippedvalues rr.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. r&root)r9r+r relative_torr.r-append)rrr1r2 skill_names r_discover_bundled_skillsrs F      %%j11 / / "   - -K     O %h ??  z9-.... Mrr2c@||}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 )rrJ)r2rrels r_compute_relative_destrs"    , ,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) hashlibmd5rcr+is_filerupdaterfencode read_bytesr>r? hexdigest)rhasherfpathrs r _dir_hashrs []]F IOOC0011 2 2E}} 2'' 22 c#hhoog66777 e..00111  2 W          sB*CCCrLbasec@||}|}t|}d|jD}|s|rt d|Drt d|d|S)zLReturn a normalized relative POSIX path, rejecting traversal/absolute paths.cg|]}|dv| S)>r'.rrVparts r z*_safe_rel_install_path..s" B B BdD ,A,AT,A,A,Arc3"K|] }|dkV dS)z..Nrrs rrWz)_safe_rel_install_path..s&-M-Mtddl-M-M-M-M-M-MrzUnsafe optional skill path: /)ras_posixrparts is_absoluteany ValueErrorrb)rLrrposixpurers r_safe_rel_install_pathr s   4 C LLNNE   D B Bdj B B BE AA#-M-Mu-M-M-M*M*MA???@@@ 88E??rcg}t|dD]P}|r:|||Q|S)z8List files inside a skill directory in lock-file format.r)rcr+rrrr)r2filesrs r_skill_file_listrsoE ,,--BB ==?? B LL**955>>@@ A A A Lrcd ddlm}||S#t$rt|cYSwxYw)zJReturn the same hash style the skills hub lock uses, falling back locally.r) content_hash)tools.skills_guardrrIr)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. r&r) r"r9rcr+rrrrrr-r.) optional_dirindexr1src install_path folder_namer3r~s r_optional_skill_indexr,s%&&L.0E     <--j99::(( !   . .\     o 1#|DDLL    H h +HkBBlC0"k"' Ls8B  BB backup_rootc6|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.TrQry-) rrJrrar9 with_namer-shutilmoverfr)rLrrtargetr\s r_move_to_restore_backuprIs    : & &C 3 F Mt444 }}=&+888899@@BB  aKF&+888899@@BB !!V[";";6";";<< KD 3v;;''' <<>>rF)restorer-rct}|sddgggdS|dvr1tt|dng}|s%||}| dd|gggdS|g}g}g}t jtj d }td z d |z }|D]\} } } tt| d z } t| } | ot| | k}t| d z | }g}trttd D]}t#|r|j} |tn#t($rYAwxYwt||j}|| kra|j| ks|| |hvr|||r|D]9}|r#|t/||:| r%|s#|t/| || sF| jddt3j| | || |st7d}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)Nryr)items rz1restore_official_optional_skill..bs 47rkeyNz#Official optional skill not found: z %Y%m%d-%H%M%Sz.restore-backupszofficial-optional-rr&TrQquietz(Official optional skill repair complete.r')rrrrr backup_dir)rrcr*valuesgetrnowrutcstrftimerJrrzrr9r.r+rrrrr-rrrarcopytree_backfill_optional_provenancerf)r-rrtargetsrrr timestamprrrrdestsrc_hash canonical_oksrc_frontmattermatchesr1 candidatecandidate_namematchrs rrestore_official_optional_skillrWs " # #E K(VdfvxHJKK KGK|G[G[fS((.B.BCCCCacG 4 >,XRV,X,XfhxzJLMM M(HI X\**33ODDI114T4T4TTK*1##& \3D,"4"4S"9"9::S>>{{}}D4H)D +3+;[II       .":#3#3J#?#?@@ . .)(33$O ))*5555!H!1(IN!K!K$$>[00N{TcFd4d4dNN9---    R R<<>>R$$%>>T*** ,,,   /T:::J= *3;c+&&&   sF)) F65F6ci}ts|StdD]}t|r|j} |tn#ttf$rYlwxYw| |j g ||S)zCIndex installed skills by directory name with one active-tree scan.r&) rJr9r+rrresolverr>r setdefaultr-r)rr1rs r#_index_installed_skill_dirs_by_namers#%E      $$Z00 ? ? !( + +  O        + +J,>,>,@,@ A A A A$    H  ,,33I>>>> Ls>BB%$B%skill_dir_nameinstalled_indexc|rtsdS|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. Nryr)rJr9rrlen)rrrs r!_find_installed_skill_dir_by_namersj !2!2!4!4t=??!!."55G 7||qt 1:rrc 6t}|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|ss|t-}t/| j|}| t|t} n4#t$r'} t d|| Yd } ~ &d } ~ wwxYw| |vr4t1|t1| krVt3jt6j}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.jsonrr6ry)version installedrcbh|],}t|t|d-S)r) isinstancedictr)rVentrys r z0_backfill_optional_provenance..sD  eT " " .!!rFNr&z/Skipping optional skill with unsafe path %s: %srz(Skipping relocated optional skill %s: %sofficialz official/builtinrbackfilled_fromr!) source identifier trust_level scan_verdictrrrmetadata installed_at updated_atTz = z* (official optional provenance backfilled)rQr)indent ensure_asciirTz.lock_rXrYr])1r"r9rJjsonloadsr:JSONDecodeErrorr>rrrcr+rrrrrorpr-rrzis_dirrrrrrrr isoformatrrr,rprintrar`dumpsrerfrgrhrirjrkrlrrmrn)rr lock_pathrqrexisting_pathsrchangedinstalled_dir_indexr1rrru lock_namerrr`payloadrrrsrts rrrs%&&L     V#k1I/DMDTDTDVDV{tz)--w-??@@@hixz\{\{  ' *///2../ R00I%%''N JG;?<--j99::6P6P !( + +  o 1#|DDLL    LLJCQR S S S HHHH H  ! !\^%C%C D,"4"4S"9"9::{{}} DKKMM #*&I&K&K#4SX?RSSD| 5dJGG     GqQQQ  > ) )  T??inn , , L..88::  4l44$()$//(%d++*,=>%# ) <((()$$$ P NNNN O O Otd;;; *T!%@@@4G''I$%%(  H 2sW555 %    $$$ % % % % % % % % % % % % % % % 8Y / / / /     (####        sAA55BB D E(E  EG,, H6HHO$,AO< O$O  O$O O$$ P/PP PPPPcBtdz 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. rrrr6rrr)rJr9r*rrr:rr>rrrrr,rfr<)rrqpathsrrs r_read_hub_install_pathsr7sV#k1I     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. r&) rJr9r+rrr.r-rr)rr1r2r-s r_index_active_skillsrOs $&E      $$Z0055 !( + +  O ).99 r"")))4444 Lrr origin_hashr active_index hub_pathsc |sdS||gD]}||ks|s |t}n#t $rYXwxYw||vrat ||krI|sFtd|d|td|d|d  |j ddtj t|t|n7#ttf$r#td ||d YdSwxYwtd |||sCtd |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.TrQz)Could not relocate renamed skill %s -> %sr^z)Relocated renamed bundled skill: %s -> %su → z (moved u → ))rrrrJrrrrrrarrrfr>r?rowarninginfo)rrrrrrrrs r_recover_renamed_skillras80 t!%%j"55##   I$4$4$6$6   '' 33<<>>CC    H  )    Y  ; . . 4Z44'' 33<<>>44(+44:D444   K  dT  : : : KID 2 2 2 2!    NN;Y    444    ?DQQQ e c:ccscc9I9I*9U9U9^9^9`9`ccc d d d 4s$,A'' A43A4A D%%/EEc 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&||h#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)rrrrr  suppressedr!r"rQch|]\}}|Srr)rVr-rBs rrzsync_skills..s888gdAT888rNz.bakz#Recovered orphaned skill backup: %sz*Could not recover orphaned skill backup %sr^r'ryu ⇢ z7 (deferred to external_dirs, not written to local tree)u ✓ removed stale shadow of 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 : 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) rrrrr r$ relocatedr!r"shadowed_by_external)* HERMES_HOMENO_BUNDLED_SKILLS_MARKERr9rrrJrarDrrNr4rrr with_suffixrrrrfrorr>r?rrrrrr*_rmtree_writablepopr_is_tracked_user_modificationrprckeysr+rcopy2rvrr) rrmanifestbundled_skills bundled_namesr$external_indexr(rrrrrsuppressed_skippedr'rr skill_srcr bundled_hash_orphan _moved_fromrur user_hashbackupr r-desc_mdr dest_descr"s r sync_skillsr>s  ..6688  ` ^ _ _ _RAB.0T   #$$K      RABbST.0   TD111H-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!!+..$ !! B B &&td&CCC Wi0000W% B B B 4gqAAAAAAAA B  BH%B%O%O%O"&(^,,*H 4   sA&G.G54G5B*OO4O//O4A'YAV UV.V  V V  VY9Y WY.X Y X  AYYZ )ZZ  1]^ #^^ 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)rgrLdirnamechmodS_IRWXUr>)funcrr_rstats r _on_errorz#_rmtree_writable.._on_errorstwu--u5  F ....     U sA A A)onerror)rrrJrRrrFrrmtree)rLr skills_rootrGrFs @rr,r,s($ZZ   ! !F$$&&K&.(( ,& , , , , ,   KKK M$ ******rc.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 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 r&u3. 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.) rDrrrrr9r,r>r?rvr>)r-rr1rr2bundled_by_name in_manifest is_bundleddeleted_user_copyrrurOrNrs rreset_bundled_skillrWsG0H"$$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 r:c,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)rr:s rr.r.Ks    9k!99rct}|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). r')r-r bundled_srcc|dS)Nr-r)rus rrz3list_user_modified_bundled_skills..xs & rr) rDrrrrr9r.rrsort)r1rmodifiedrr2rrs r!list_user_modified_bundled_skillsr_WsH  "$$KH!9+!F!F   Ill:r22   %i=={{}}   (ioo F F  OO#T)LL    MM))M*** Orc |}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)rr>decodeUnicodeDecodeError)rLrqs r_read_for_diffre|s   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``. rNFrMzv' is not a tracked bundled skill (no stock version to diff against). Hub-installed skills use `hermes skills inspect`.)rr-foundr^diffsrTzNo local copy of 'z ' found at rrabinaryz)rLstatusdiffr')keependszstock/zyours/)fromfiletofiler^addedz+ only in your copy: removedz- only in stock: z' matches the stock version.z$' differs from the stock version in z file(s).)difflibrrrrrr9r*rrcrerrb unified_diffr;rYr)r-rqrrSr[r user_files stock_filesrhrin_userin_stock user_bytes user_text stock_bytes stock_texttextr^s rdiff_bundled_skillr|s4NNN"$$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   renabledcttz }|} |r=tdd|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). TrQzThis profile opted out of bundled-skill seeding (`hermes skills opt-out`). Delete this file to re-enable sync on the next `hermes update`. rr6zpOpted 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 r&)rr markerrN)r)r*r9ra write_textrnr>rf)r}rexistedr rrus rset_bundled_skills_opt_outrsU3 3FmmooG     dT  : : :   T!     "kGIGGI G  G>??>     ES[[JVJJqJJ         7c&kkg V VVsAB B1 B,&B1,B1cDttz S)z=Return True if the active profile carries the opt-out marker.)r)r*r9rrris_bundled_skills_opt_outr$s 2 2 : : < <r?rvr)rr1rrSrprr-rrron_diskruverbrs rremove_pristine_bundled_skillsr)s#.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/ ...rrz newrz updatedrz unchangedrz, z, +z morez user-modified (kept): r z cleaned from manifestr"z official optional backfilledz Done: z. r!z total bundled.rA)F)W__doc__rrloggingrgrsysrrpathlibrrstdoutstderr_streamhasattrrr TypeErrorhermes_constantsr rrr(rtypingrrrrrutilsr getLogger__name__ror)rJr8r*rr"rfr4rDr*rNrvr.rrrrrrrrrYrrrrrrrrr>r,rWr.r_bytesrer|rrrrr@rrrMMAX_SHOWrbshownrrrrrrs.  '''''''''''''''' CJ'Gww &&      C C C CI&    D  ^]]]]]]]]]44444433333333333333  8 $ $o 8 # 00 0K$KKKKU4UUUU SX:S#X64`T#s(^````Btss*$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*