+ lHjXa0t$Rt^RIHt^RIt^RIt^RIt^RIt^RIH t H t ^RI H t H t H t ^RIHt^RIHtHtHtHtHtHtHtHtHt^RIHt^RIHtHt^R IH t ]PB!]"4t#Rt$^RI%t%R R R ut't(t)]'](])0t*]+!4t,R ]-R&RRlt.RRlt/RRlt0RRlt1RRlt2]Pf!4t4] RRl4t5Rt6RRlt7RRlt8R R!lt9R"R#lt:R$R%lt;R&R'ltR,R-lt?R.R/lt@R0R1ltAR2R3ltBR4R5ltCR6R7ltDR8R9ltER:R;ltFR<R=ltGR>R?ltHR@RAltIRBRCltJRDREltKRRFRGlltLRHRIltMRJRKltNRLRMltORNROltPRPRQltQRRRSltRRTRUltSRVRWltTRXRYltURZR[ltVR\R]ltWRR^R_lltXR`RaltYRbRcltZRdRe/RfRgllt[RhRilt\RjRklt]RRlRmllt^RnRRoRRpR/RqRrllt_RsRtlt`RuRvltaRoRRpR/RwRxlltbRyRzRoRRpR/R{R|lltcRoRRpR/R}R~lltdRRlteRRltfRRltgRRlthRRltiRRltjRRltkRRltlRRltmRRltnRRltoRRltpRRltqRRltrRRltsRRlttR# ]&d:Rt%] !]&4;_uu_4^RI$t$RRR4EK +'giEL-;ii;i)uGSkill usage telemetry + provenance for the Curator: a sidecar ``~/.hermes/skills/.usage.json`` keyed by skill name (never frontmatter — keeps telemetry out of user-authored SKILL.md and off bundled/hub skills). Counter bumps are best-effort (DEBUG-logged failures never break the tool call); writes are atomic under a cross-process lock. Curator management is an explicit ``created_by: agent`` marker written by skill_manage — never inferred from location. Lifecycle: active -> stale -> archived (moved to .archive/); ``pinned`` opts out of auto transitions, orthogonal to state.) annotationsN)contextmanagersuppress)datetimetimezoneUTC)Path) AnyCallableDictIterableIteratorListOptionalSetTupleget_hermes_home)is_excluded_skill_pathis_external_skill_path)atomic_write_textactivestalearchivedset[str]PROTECTED_BUILTIN_SKILLSc V^8dQhRRRR/# skill_namestrreturnbool)formats"6/home/ubuntu/.hermes/hermes-agent/tools/skill_usage.py __annotate__r&+s22S2T2cV\9#N)rrs&r%is_protected_builtinr++s 1 11r'cV^8dQhRR/#rr!rr#)r$s"r%r&r&/s((T(r'c$\4R, #)skillsrr#r'r% _skills_dirr0/s  x ''r'cV^8dQhRR/#r-r#)r$s"r%r&r&3s))T)r'c$\4R, #)z .usage.jsonr0r#r'r% _usage_filer43s == ((r'cV^8dQhRR/#r-r#)r$s"r%r&r&7s&&d&r'c$\4R, #)z.archiver3r#r'r% _archive_dirr77s =: %%r'c V^8dQhRRRR/#)rlockr"r!Noner#)r$s"r%r&r&;sPPTPdPr'cX\'dA\P!Y'd\P4#\P4#VP ^4\ P !VP4V'd\ PM\ P^4R#)N) fcntlflockLOCK_EXLOCK_UNseekmsvcrtlockingfilenoLK_LOCKLK_UNLCK)fdr9s&&r%_flockrH;sW u{{2u}}HH%--HHGGAJ NN299;$FOOQOr'cV^8dQhRR/#)r lock_pathrr#)r$s"r%r&r&Fs""t"r'c #"\V4p\\RR4pVf\4;p\n\ f \ eW9dRxR#VPPRRR7\ 'dIVP4'd VP4P^8XdVPRRR7\T\ 'dRMR RR7;_uu_4p\VR4VPV4RxVP!V4\#\$\&4;_uu_4\VR 4RRR4RRR4R# +'giL;i TP!T4\#\$\&4;_uu_4\TR 4RRR4i +'gii;i;i +'giR#;i5i) zExclusive cross-process lock on ``lock_path`` held across a read-modify-write cycle. Re-entrant within one thread (a nested acquire of the same path just runs); a no-op where neither fcntl nor msvcrt exists.pathsNTparentsexist_ok zutf-8encodingzr+za+F)rgetattr _held_lockssetrLr=rBparentmkdirexistsstatst_size write_textopenrHadddiscardrOSErrorIOError)rJheldrGs& r%skill_file_lockrbEsH YI ; .D |#&5({  &.Y->  4$7 vy''))Y^^-=-E-E-JS73 iTG D Dr4  "  LL #'7++r5!, E D,+ LL #'7++r5!,+++ E D DssA:G=GAG)GE+ -G9 E G G E( #G+.G F/ & G/ F?:GG G  GcF\\4PR44#)z@Serialize .usage.json read-modify-write cycles across processes.z .json.lock)rbr4 with_suffixr#r'r%_usage_file_lockre_s ;=44\B CCr'c$V^8dQhRRRRRR/#)rpathrfail_logr r! list[str]r#)r$s"r%r&r&ds!dcir'cVP4'g.#RVPRR7P44Uu.uFq"'gK VNK up#uupi \d"p\P Y4.uRp?#Rp?ii;i)zNStripped, non-empty lines of a small metadata file ([] if missing/unreadable).c3@"TFqP4xK R#5ir))strip.0lines& r% _read_lines..isg5fTJJLL5fs utf-8-sigrQN)rX read_text splitlinesr_loggerdebug)rgrhses&& r% _read_linesrydsp ;;== gT^^[^5Y5d5d5fgmgaklgmmm  X! s5)A AAAA B *BB B cV^8dQhRR/#)rr!r r#)r$s"r%r&r&os))#)r'cR\P!\4P4#r))rnowr isoformatr#r'r%_now_isor~os <<  & & ((r'c V^8dQhRRRR/#)rvaluer r!zOptional[datetime]r#)r$s"r%r&r&ssVVV(:Vr'cV'd \P!\V44MRpT'd%TP fTP \R7#T# \\3dR#i;i)N)tzinfo)r fromisoformatr TypeError ValueErrorrreplacer)rparseds& r%_parse_iso_timestamprss[7<''E 3$*0FMM4I6>>> %UvU z "sA!AA.-A.c V^8dQhRRRR/#)rrecorddict[str, Any]r! Optional[str]r#)r$s"r%r&r&{sBB~B-Br'caV3RlR4Uu.uF!p\V4;pfKV\V43NK# ppV'd\VRR7^,#R#uupi)zhNewest use/view/patch timestamp; ``created_at`` is excluded so never-active skills stay distinguishable.c3F<"TFpSPV4xK R#5ir))get)rnkrs& r%rp%latest_activity_at..}s(v@u1A@us!NcV^,#r<r#)ts&r%$latest_activity_at..sQqTr')key) last_used_atlast_viewed_atlast_patched_at)rr max)rrawdtstampssf r%latest_activity_atr{s^(v@u(v@(v,S11"r3s8n(vF@173v> *1 -ATA@s AAc V^8dQhRRRR/#rrr r!intr#)r$s"r%r&r&sr'c^\T;'g^4# \\3d^#i;ir)rrrrs&r% _int_or_zerors.5::A z "s ,,c V^8dQhRRRR/#rr#)r$s"r%r&r&sIISISIr'c\\V\4'd^#\^\V44#r) isinstancer"rrrs&r%_non_negative_intrs%5$''1HSL4G-HHr'c V^8dQhRRRR/#)rrrr!rr#)r$s"r%r&r&sdd>dcdr'c.a\V3RlR44#)z%Total observed use+view+patch events.c3X<"TFp\SPV44xK! R#5ir))rr)rnrrs& r%rp!activity_count..s#c8b|FJJsO,,8bs'*) use_count view_count patch_count)sumrsfr%activity_countrs c8bc ccr'cV^8dQhRR/#rr!rr#)r$s"r%r&r&siiXir'c\\4R, R4pRV4Uu0uFq'gK VkK up\4,#uupi)a(Built-in names: ``.bundled_manifest`` ("name:hash" per line) plus the curator suppression list, which only ever records built-ins; a pruned built-in whose manifest entry an older sync cleaned after the catalog dropped it is still not agent-authored (#95415). Empty if both are missing/unreadable.z.bundled_manifestz#Failed to read bundled manifest: %sc3n"TF+qPR^4^,P4xK- R#5i):N)splitrlrms& r%rp&_read_bundled_names..s*H%$ 3*1-3355%s35)ryr0read_suppressed_names)linesns r%_read_bundled_namesrsE  (;;=b cEH%H NH!AAAH NQfQh hh Ns A A cV^8dQhRR/#rr#)r$s"r%r&r&s8r'c\4pVR, R, pVP4'g \4#\P!VP RRR74p\ V\4'dVPR4;'g/MRp\ V\4'g \4#VUu0uFp\V4kK ppRVP44pR V4FpW, P4pVPVP44TR , P4'gKXTP\!TR , TP"R 74K V#uupi \\3dKi;i \\P$3d*p \&P)R T 4Rp ? \4#Rp ? ii;i) zdHub-installed names (``.hub/lock.json``) plus the frontmatter name of each in-tree ``install_path``.z.hubz lock.jsonrrrrRerrors installedNc3t"TF.p\V\4'gKVPR4xK0 R#5i) install_pathNrdictr)rnrxs& r%rp,_read_hub_installed_names..s,Z0B1jQRTXFY&~&&0Bs88c3"TF7p\V\4'gKVP4'gK3VxK9 R#5ir))rr rlrnps& r%rprs%R1As1CQ QQsAA ASKILL.mdfallbackz Failed to read hub lock file: %s)r0rXrUjsonloadsrsrrrr valuesresolve relative_tor_rr]read_skill_namenameJSONDecodeErrorrurv) skills_dirrJdatarrnamesrLrresolvedrxs r%_read_hub_installed_namesrsJV#k1I     u <zz)--{9-UV5?d5K5KTXXk*00bQU )T**5L!*+AQ+Z 0@0@0BZRRL &5>>@$$Z%7%7%9::%--// /(Z*?(--XYS , Z(   T)) *< 7;; 5LDDU ?? ?s AAc$V^8dQhRRRRRR/#)rrr r]r"r!r:r#)r$s"r%r&r&s& W W WT Wd Wr'c~V'dV\4;p9V8XdR#V'd VPM VP!V4\\ 4R, RP \ V44V'dRMR,RR7R# \d$p\PRTRR 7Rp?R#Rp?ii;i) zdAdd (built-in pruned) or drop (restored) *skill_name* in the suppression list; no-op when unchanged.Nr z.curator_suppressed_ tmp_prefixz,Failed to write curator suppression list: %sTexc_info) rr]r^rr0joinsortedrrurv)rr]rrxs&$ r%_toggle_suppressed_namers *2G2I)IJsRUYY5==(*5W+-*??6RW=AYej]aprAs%; = W CQQU VVWsAB B<B77B<c$V^8dQhRRRRRR/#)rbaser local_onlyr"r!zIterator[tuple[str, Path]]r#)r$s"r%r&r&s'UU$UtU8RUr'c#"VPR4FUp\V4'dKV'd\V4'dK1\W"PP R7V3xKW R#5i)z``(frontmatter name, SKILL.md)`` under *base* minus metadata/VCS/venv/cache dirs; *local_only* also skips external skill dirs mounted below the tree (curation must not touch them).rrN)rglobrrrrVr)rrskill_mds&$ r%_iter_skill_mdsrsMJJz*&x00ZDZ[cDdDd!(__5I5IJHT T+s#A/A/A/*A/c V^8dQhRRRR/#)rkeepz5Callable[[str, Path, set[str], dict[str, Any]], bool]r!rir#)r$s"r%r&r&s ttRtW`tr'c 8\4;pP4'g.#\4\4\ 4rCp\ \ VRR7UUu0uF3wrVWR9gK \V4'dK V!WVW44'gK1VkK5 upp4#uuppi)zlSorted local skill names passing *keep(name, skill_md, bundled, usage)*; hub/protected names never reach it.Tr)r0rXrr load_usagerrr+)rrhubbundledusagerrs& r%_scan_local_skillsrsM !D ) ) + + 357J7Ljl%C odt.Ts.TNDo.B4.HMQRVbiMq4.Ts ttss B $B 7 B B cV^8dQhRR/#rr!rir#)r$s"r%r&r&s~~ ~r'c6a\4o\V3Rl4#)zCurator-manageable skills: ``created_by: agent`` records plus, with ``curator.prune_builtins``, bundled built-ins (which never carry a managed record, so the record gate applies only to local skills). Never hub.cH<W9dS#\VPV44#r))_is_curator_managed_recordr)r_mdrrrs&&&&r%r0list_agent_created_skill_names..s$DO.*|Qklqluluvzl{Q|*|r')rr)rs@r%list_agent_created_skill_namesr s-.N | ~~r'cV^8dQhRR/#rr#)r$s"r%r&r&s[[9[r'c\4pVP4'dK\VP4Uu0uF&qP 4'gKVP kK( up4#.#uupi)u`Skills in ``.archive/`` — flat layout (``archive_skill`` flattens), so dir name == skill name.)r7rXriterdiris_dirr)rootrs r%list_archived_skill_namesrsH >DEI[[]]64<<>@>aXXZ6166>@ AZXZZ@s A-A-c$V^8dQhRRRRRR/#)rrrrr r!r#)r$s"r%r&r&s! 4 4d 4c 4c 4r'cvVPRRR7R,PR4Uu.uFq"P4NK ppRT9dT#Y3P R4^,RpRT9dTRTP R4MTpRT4p\ R T4T4#uupi \dTu#i;i) zRThe frontmatter ``name:`` field of a SKILL.md (first 4000 chars), else *fallback*.rrrr:NiNrz---Nc3"TFSqPR4'gKVPR^4^,P4PR4xKU R#5i)zname:rz"'N)rrrlrms& r%rp"read_skill_name..sD gUToo^eNf8djja #))+11%88Us A>Ac38"TFq'gK VxK R#5ir)r#)rnvs& r%rprs(FqaFs  )rsrrlr_indexnext)rrrorblockrs&& r%rrs*2*<*.5s@)<*+*+E_`e`i`ijn`oEpAp*+*+  **+r')rr#r'r%list_unmanaged_skill_namesr?0s  + ,,r'cV^8dQhRR/#rr!zlist[dict[str, Any]]r#)r$s"r%r&r&9s33.3r'c \4p\4Uu.uF5p\WPV4RVPV/49W9R7NK7 up#uupi)zRows for :func:`list_unmanaged_skill_names`; ``has_provenance_key`` (False = pre-dates ``created_by``) explains WHY, it is not a signal to adopt on.r4)has_provenance_key has_record)rr? _report_rowr)rrs r%unmanaged_reportrF9sZ LE/1 31 99QO'>tq!,dad'>O PPOs AAc(V^8dQhRRRRRRRR/#)rrr rr extrar!rr#)r$s"r%r&r&ks(ccnr'c rRV/\V4CVCpVP\V4\V4R7V#)r)last_activity_atr)r_updaterr)rrrarows&&, r%rErEks< 4 5;s+ 5u 5CJJ 23 7WZH[J\ Jr'cV^8dQhRR/#)rr!dict[str, dict[str, Any]]r#)r$s"r%r&r&qsii-ir'c\4pVP4'd'\P!VP RR74M/p\T\4'dGTP4UUu/uF)wr4\T\4'gK\T4TbK+ upp#/# \ \P 3d#p\PRY4/uRp?#Rp?ii;iuuppi)zKThe whole .usage.json map (non-dict values dropped); {} on missing/corrupt.rrrQzFailed to read %s: %sN) r4rXrrrsr_rrurvrrr^r )rgrrxrrs r%rrqs =DCG;;==tzz$..+.>?VXKUUY[_J`J`$**, F,$!*Q2EICFAI, Fhfhh T)) * ,d6  Gs)>B(3C(C((C%C C% C%c V^8dQhRRRR/#)rrrgr!r"r#)r$s"r%r&r&|s.4r'c \4p\V\P!V^RRR7RR7R# \d$p\ P RYRR7Rp?R#Rp?ii;i) z7Write the usage map atomically; True when it committed.TF)indent sort_keys ensure_asciiz.usage_rzFailed to write %s: %srN)r4rrdumpsrrurv)rrgrxs& r% save_usagero|sT =D$ 4TX] ^ktu  -t Fs&4 A"AA"c V^8dQhRRRR/#)rrr r!rr#)r$s"r%r&r&s5535>5r'cF\\4PV44#)zDThe (backfilled) record for *skill_name*; fresh defaults if missing.)r_rrr*s&r% get_recordrrs z|'' 3 44r'c ,V^8dQhRRRRRRRRRR /#) rrr opz7Callable[[dict[str, dict[str, Any]]], tuple[Any, bool]]rhguardzOptional[Callable[[], bool]]r!r r#)r$s"r%r&r&s3  s (_ kn 6 BE r'cPVeV!4'gR#\4;_uu_4\4pV!V4wrVV'd\V4'gRMTuuRRR4# +'giR#;i \d$p\P Y TRR7Rp?R#Rp?ii;i)z*op(data) -> (result, dirty)* under the file lock, saving only when dirty; *guard* runs before locking. None when the guard failed, the save did not land, or anything raised (DEBUG-logged via *fail_log*).NTr)rerrorrurv)rrtrhrurresultdirtyrxs&&&& r%_locked_updaterysw   UWW   ._seedsd4/NNDOOJQAS`SbQAdsu}uQA5BJN5NN Nr'z1skill_usage.seed_record_if_missing(%s) failed: %sN)r1ry)rrsf r%seed_record_if_missingrs+*:66 Nz5*]^ 7zr'c V^8dQhRRRR/#r{r#)r$s"r%r&r&s   s  t  r'c(RRlp\W4R#)uStart a skill's inactivity clock NOW, once. Telemetry writes a record the moment a bundled skill is seeded, so by the curator's first sight ``created_at`` can be months old and every never-used built-in goes stale on that first pass (#79295); ``first_seen_at`` marks the clock as anchored so later runs age it normally. A record the bug already marked stale is reactivated — the staleness was the artifact.c V^8dQhRRRR/#)rr\rr!r:r#)r$s"r%r&$reanchor_clock..__annotate__s((N(t(r'ct\4;VR&VR&VPR4\8Xd \VR&R#R#)rTrXrUN)r~r STATE_STALErYr\s&r%_applyreanchor_clock.._applys73;:=LC0 777 { *'CL +r'N_mutaterrs& r%reanchor_clockrs ( Jr'require_curation_eligibleFc$V^8dQhRRRRRR/#)rrr rr"r!r r#)r$s"r%r&r&s'mmmDmUXmr'cdaaS'gR#\SVV3RlRV'd V3Rl4#R4#)zLoad, apply *mutator(record)* in place, save; the mutator result (None if nothing landed). Telemetry is recorded for ANY skill; lifecycle mutators pass ``require_curation_eligible=True`` (never write onto unmanaged).NcH<S!VPS\444R3#T)r~rZ)rmutatorrs&r%r_mutate..sGDOOJXeXgHaC mmgk mmr'c(V^8dQhRRRRRRRR/#)rrr rrr r!r"r#)r$s"r%r&r&s.ss3sSsssr'c>aa\\VVV3RlRR74#)zCCuration-gated single-field write; True only when the write landed.c><VPSS/4;'gR#r)rd)r\rrs&r%r_set_field..s C<0H0P0PD0Pr'Tr)r"r)rrrs&ffr% _set_fieldrs  $Plpq rrr'c(V^8dQhRRRRRRRR/#)rr\r count_keyr ts_keyr!r:r#)r$s"r%r&r&s(~#str'cd\VPV44^,W&\4W&R#)N)rrr~)r\rrs&&&r%_bumprs%&swwy'9:Q>CN*CKr'c$V^8dQhRRRRRR/#)rrr rOptional[dict[str, Any]]r!r#)r$s"r%r&r&s(iiSi2JiVYir'c \V4'g\V4'dR#RV9dK\\4;_uu_4^RIHpV!4P V4e RRR4R#RRR4RRRR/P\V\4'dVPR4MR4;p'dV#\V4eR#\V4f\V\4'dR #R # +'giL;i) z2Bounded provenance label for shared skill metrics.rr)get_plugin_managerNr5r6r4externallocalunknown) rrrrhermes_cli.pluginsrfind_plugin_skillrrrr!r )rrrlabels&& r%telemetry_provenancers ##z*'='= j i =!#55jAM"! M!k7ODHH(264(@(@FJJ| $dLLuL  +7%j1=FTXAYAY7h_hh! s  C22 D rtask_id session_idc 0V^8dQhRRRRRRRRRRR R /#) rrr actionrrrrrr!r:r#)r$s"r%r&r&sB g gc g3 gC[ g#0 gER g^b gr'c XT;'g/p^RIHpHpV!R4'd]T!RY\W4T;'gRT;'gRVP R4VP R4VP R4R7 R #R # \ d\ PRYR R 7R #i;i) zfBest-effort lifecycle hook after an authoritative state change; facts absent from *record* go as None.)has_hook invoke_hookon_skill_lifecyclerrreusedreuse_after_patch)rr provenancerrrrrz+skill_usage lifecycle hook failed for %s/%sTrN)hermes_cli.lifecyclerrrrrrurv)rrrrrfactsrrs&&$$$ r%_emit_skill_lifecyclers LLbEg> ( ) ) ,V#7 #KU\UbUb`b#-#3#3uyy?U^c^g^ghp^q*/))4G*H J * g BJae fgsB!B8B#B)(B)c ,V^8dQhRRRRRRRRRR /#) rrr rrz*Callable[[dict[str, Any]], dict[str, Any]] hook_kwargsr r!r:r#)r$s"r%r&r&s9OOOcO>jNN+N?r'c V^8dQhRRRR/#r{r#)r$s"r%r&r&sPP#P$Pr'c \VR4R#)c\VRR4#)rr)rrs&r%rbump_view..sE#|=M$Nr'Nrr*s&r% bump_viewrs  JNOr'c(V^8dQhRRRRRRRR/#)rrr rrrr!r:r#)r$s"r%r&r&s/ [ [ [- [M [ei [r'c0RRlp\VRW1VR7R#)zVSkill actively used (loaded into the prompt path / referenced from an assistant turn).c V^8dQhRRRR/#rr\rr!r#)r$s"r%r&bump_use..__annotate__s88N8~8r'cv\VPR44p\VPR44p\\VPR44V4pV^8;'dW#8pTPV^,\ 4TV'dTMTR7RVPR4RV^,RV^8RV/#)rrRrS)rrrRrSr4rr)rrminrdr~)r\usesgen last_reusedrs& r%rbump_use.._applys !56(: ;<+CGG4R,STVYZ  1H::): TAXHJQT7Hk  [cggl3[$(HVZ]^V^#%68 8r'loadedrrNr)rrrrs&$$ r%bump_users8Z6zZr'rpatchc ,V^8dQhRRRRRRRRRR/#) rrr rrrrr!r:r#)r$s"r%r&r&s1,,3,3,=,(,48,r'c@RRlp\YR8XdRMRWBVR7R#)z&Called from skill_manage (patch/edit).c V^8dQhRRRR/#rr#)r$s"r%r& bump_patch..__annotate__s55N5~5r'c\VRR4\VPR44^,VR&RVPR4/#)rrrRr4)rrrrs&r%rbump_patch.._applysC c="34"3CGG.__annotate__s11N1~1r'c<VP4TP\4S'dRMRR7RVR,/#)r5learn)r4r4)clearrdrZ)r\r6s&r%rrecord_created.._applys2  =?-wW Uc,/00r'createdrNr)rr6rrrs&d$$ r%record_createdr s11ZFPZ[r'c V^8dQhRRRR/#r{r#)r$s"r%r&r&s6666r'c,RRlp\VRV4R#)zBRecord a successful Skills Hub install without exporting its name.c V^8dQhRRRR/#rr#)r$s"r%r&&record_installed..__annotate__s++N+~+r'c:VPR\RR7RR/#)rN)r4rUrWr4)rdrYrs&r%r record_installed.._applys k4 Pk**r'rNrrs& r%record_installedrs+Zf5r'c V^8dQhRRRR/#r{r#)r$s"r%r&r&!s223242r'c \VRR4R#)ueOpt a skill into curator management — the only thing that makes it eligible for automatic curation.r4r5N)rr*s&r%rMrM!sz<1r'c$V^8dQhRRRRRR/#)rrr rUr!r:r#)r$s"r%r&r&&s&DD#DcDdDr'caS\9d\PRSV4R#RV3Rllp\WRR7p\ V\ 4'doVR,'d^S\ 8H;'dVR,\8HpV'dR M\R \R /PS4pVe\WVR 7R#R#R#R#) znSet lifecycle state (no-op if invalid / unmanageable). Emits archived/stale/restored; active<-stale is silent.z"set_state: invalid state %r for %sNc V^8dQhRRRR/#rr#)r$s"r%r&set_state..__annotate__,sooNo~or'c<VPR4pVS8wd+SVR&S\8wdS\8Xd \4MRVR&RVS8gRVPR4RV/#)rUNrWchangedr4previous_state)rrSTATE_ARCHIVEDr~)r\previousrUs& r%rset_state.._apply,sc777# u  CL #38N3JXZPTM"8u,lCGGLaS'd\SV3RlR4R#R#)c0<RVPSR4RJ3#r))pop)drs&r%rforget..FsdAEE*d4KSW4W-Xr'z!skill_usage.forget(%s) failed: %sNrr*sfr%forgetrDsz#XZ}~r'c 0V^8dQhRRRRRRRRRRR R /#) rsrcrdestrr rcapture_kwargsr r!rIr#)r$s"r%r&r&Js8((4(t((c(UX(]m(r'c .^RIHpVP!V3/VBpVP V4TR8Hp T 'd7\\ 4;_uu_4\P!T4RRR4T 'd\T4'd \Y)R7\Y)'d\M\ 4\\4;_uu_4TeTP#Y2T;'g.TR7RRR4R T R T 23# \dR;rVLi;i \ dR^RIpTP\T4\T44EL \dpRRT RT 23uRp?u#Rp?ii;ii;i +'giEL;i +'giL;i) zMove *src* to *dest* for *action* ("archive" | "restore") inside a best-effort audit-ledger entry, then apply suppression + state side effects; rename falls back to shutil.move across devices.) skill_ledgerNFz failed to z: archive)r])before after_rootTzd to )toolsrcapture_beforerrenamer_shutilmover rosutimerrrrrYrecord_mutation) r r rrr _ledger_ledger_beforerrx archivings &&&&, r% _relocaterJsR(1 //F~F5 4)#Ig   HHTN  :.. : jI.<H )      # #F~?S?SQS`d # e  F85' ''- (#''.( 5 5 KKC#d) , 5Jvhb44 4 5 5    sdC=DE0 F# F=D DE-!$E E) E$E)E-$E))E-0 F  F c V^8dQhRRRR/#rHr#)r$s"r%r&r&isffcf&6fr'c \V4pVf\V4eR\V43#\W4'g;\ V4'd RRV R23#\ V4'd RRV R23#RRV R23#Vf RRV R23#\ V4'dR\V43#\4V, pVPPRRR 7TP4'dHTPTP R \P!\ 4P#R 4 24p\%YTR RTR7# \dpRR T 23uRp?#Rp?ii;i)zMove a curator-eligible skill dir to ``.archive/`` (flattened; timestamp suffix on collision). Never hub; bundled built-ins only with ``curator.prune_builtins`` (and then suppressed from re-seeding).NFr*zY' is a protected built-in; it backs load-bearing UX and is never archived or consolidatedz!' is hub-installed; never archivezJ' is a bundled built-in; enable curator.prune_builtins to allow pruning itrLTrMzfailed to create archive dir: -z %Y%m%d%H%M%Sr)complete_packageskill)r r!r+r1r+rrr7rVrWr_rX with_namerrr|rstrftimer)rrNr rxs& r% archive_skillr%isw +I5jAM1*===  6 6  + +GJ<0IJJ J J ' 'GJJ &D; $6 {{}}~~ 0(,,s2C2L2L^2\1]^_ Yj)dZd ee ;6qc:::;s1D;; EE EEc V^8dQhRRRR/#rHr#)r$s"r%r&r&sAAcA&6Ar'cFa\V4'd RRV R23#\V4'd\4'g RRV R23#\4pVP 4'gR#VP R4Uu.uFq"P 4'gKVNK ppV R2oVUu.uFq"PV8XgKVNK up;'gu\V3RlV4RR 7;'gVVUu.uFHq"R , P4'gK!\VR , VPR 7V8XgKFVNKJ uppV'g RRV R 23#\4V, ;pP 4'dRR V 23#\V^,WPR4#uupiuupiuupi)zMove an archived skill back to the flat layout (nesting NOT reconstructed). Refuses a name now colliding with a hub skill, or a bundled built-in unless ``curator.prune_builtins`` is on (restoring lifts a prune).Fr*zA' is now hub-installed; restore would shadow the upstream versionz;' is now bundled; restore would shadow the upstream version*r c3 <"TFqPPS4'gK%\VP4\S4, ^8XgKQVP\S4RP4'gKVxK R#5i)N)rrlenisdigit)rnrprefixs& r%rp restore_skill..s_ -DqFF--f5#aff+F :SWY:Y VVCKL ! ) ) + Ds"B'B)B BT)reverserrz' not found in archivezdestination already exists: restore)Fzno archive directory) rrrr7rXrrrris_filerr0r)r archive_rootrdirs candidatesr r-s& @r% restore_skillr5s ## |+lmmm*&=&?&? |+fggg>L    ,,$))#. =.!((*AA.D =|1 F":TVVz%9!!T:zzf -D -6:?<zz@za N335/!j.cdcici:jnx:x4@z  |+ABBB **22444TF;;; Z]Di @@ >;@zs*9FF&F=F1F F9Fc$V^8dQhRRRRRR/#)r skill_mdszIterable[Path]rr r!r.r#)r$s"r%r&r&s&qqqCqNqr'c0a\V3RlV4R4#)c3<"TF8p\WPPR7S8XgK*VPxK: R#5i)rN)rrVr)rnrrs& r%rp#_match_skill_dir..s,i9aHHMM0Z^h0h9s 'AAN)r)r7rs&fr%_match_skill_dirr;s i9iko ppr'c V^8dQhRRRR/#rrr r!r.r#)r$s"r%r&r&sCCCCr'c^RIHp\4pVP4'd\ RV!VR44V4#R#)z3Skill dir by frontmatter ``name`` (flat or nested).)iter_skill_index_filesc3L"TFp\V4'dKVxK R#5ir))rrs& r%rp"_find_skill_dir..sr(P1XnopXqQQ(P$ $rN)agent.skill_utilsr?r0rXr;)rr?rs& r%r r sC8 =D+/;;== r(>tZ(Pr& (C>BCr'c V^8dQhRRRR/#r=r#)r$s"r%r&r&sPPPPr'cXaa^RIHp\VV3RlV!4R,4R4#)z=Skill dir under configured external dirs by frontmatter name.get_all_skills_dirsc3<"TFHqP4'gK\RVPR44S4;ofKDSxKJ R#5i)c3L"TFp\V4'dKVxK R#5ir))rrs& r%rp5_find_external_skill_dir...s/s;QaYopqYr;QrBrN)rXr;r)rnrfoundrs& r%rp+_find_external_skill_dir..sOI#<4 ./s4::j;Q/s/9;;UCGH#.sAl|)$GGH%*>t*DIXY]I^|sAA A A) _persistedr) rrUr rdr^rrErr)rrrs r%curated_reportrSsu rms1#  /,,VVV,L#   8 $ -5gz) k>{N; &)U(*2()&Poo ""2D )VBId i>@ WUt~[ 4a 5/o puD,3F6#Q i5  _  m5ms  i" g^b g37 gUY gOP [$ [\` [,,SW,+/, \UY \/3 \62 D*: (>f<A6qCP pf  ^S E +      s*4I))J)JJ) J% J)%J)