`gjSdZddlmZddlZddlZddlZddlZddlZddlmZm Z m Z ddl m Z ddl mZmZmZmZmZmZmZddlmZddlmZdd lmZej6eZd7d ZGd d eZ d8d Z dZ!dZ"dZ#dZ$dZ%d9dZ&d:dZ'd:dZ(d;dZ)ddZ.d?dZ/d>dZ0d>dZ1d=dZ2d=d Z3d@d!Z4dAdBd"Z5dCd#Z6dAdDd$Z7d%Z8d&Z9d9d'Z:dEd(Z; dFd)Z< dGd*Z= dHd+Z> dA dId,Z? dJd-Z@ dKd.ZAdLd/ZBdMd0ZC dN dOd1ZDdPd2ZEdQd3ZFdRd4ZGddd5 dSd6ZHy)TuCurator — background skill maintenance orchestrator. The curator is an auxiliary-model task that periodically reviews agent-created skills and maintains the collection. It runs inactivity-triggered (no cron daemon): when the agent is idle and the last curator run was longer than ``interval_hours`` ago, ``maybe_run_curator()`` spawns a forked AIAgent to do the review. Responsibilities: - Auto-transition lifecycle states based on derived skill activity timestamps - Spawn a background review agent that can pin / archive / consolidate / patch agent-created skills via skill_manage - Persist curator state (last_run_at, paused, etc.) in .curator_state Strict invariants: - Only touches agent-created skills (see tools/skill_usage.is_agent_created) - Never auto-deletes — only archives. Archive is recoverable. - Pinned skills bypass all auto-transitions - Uses the auxiliary client; never touches the main session's prompt cache ) annotationsN)datetime timedeltatimezone)Path)AnyCallableDictList NamedTupleOptionalSetget_hermes_home skill_usage)atomic_json_writecF|yt|j}|xsdSN)strstrip)valuetexts @/root/.hermes/venv/lib/python3.12/site-packages/agent/curator.py_strip_aux_credentialr(s& } u:   D <4cDeZdZUdZded<ded<ded<ded<ded <y ) _ReviewRuntimeBindingzCProvider/model for the curator review fork plus per-slot overrides.rprovidermodel Optional[str]explicit_api_keyexplicit_base_urlDict[str, Any]request_overridesN)__name__ __module__ __qualname____doc____annotations__rrrr/s!MM J##$$%%rrct|xsi}t|tr6|r4t|jdxsi}|j|||d<|S)z>Dct} t||ddy#t$r"}tj d|dYd}~yd}~wwxYw)Nr7T)indent sort_keysz Failed to save curator state: %sexc_info)r<r ExceptionrSrT)rVrUrZs r save_staterbtsE =DK$Q$? K 7T JJKs AAAcJt}t||d<t|yNrC)r[boolrb)rCstates r set_pausedrg|s LE6lE(OurcFttjdSrd)rer[r0r+rr is_pausedris    * ++rc ddlm}|}t |t siS|jdxsi}t |t siS|S#t$r"}tj d|icYd}~Sd}~wwxYw)zIRead curator.* config from ~/.hermes/config.yaml. Tolerates missing file.r load_configz%Failed to load config for curator: %sNcurator)hermes_cli.configrlrarSrTr/r.r0)rlcfgrZcurs r _load_configrqso1m c4  '')  "C c4  J  Nuudeferred first run — curator seeded, will run after one interval; use `hermes curator run --dry-run` to preview nowr@z&Failed to seed curator last_run_at: %stzinfo)hours)rvrir[rr0rnowrutc isoformatrbrarSrTrreplacerr})rrflastrZintervals rshould_run_nowrs* <{ LE eii . /D | ;,,x||,C F#&==?E- N $ % u  {ll8<<( {{||8<<|0134H $J8 ## F LLA1 E E Fs##C44 D=DDc ddlm}|S#t$r,}tj d|dt cYd}~Sd}~wwxYw)zSkill names referenced by any cron job (incl. paused/disabled). Best-effort: a cron-module import error or corrupt jobs store must never break the curator, so any failure yields an empty set (no protection, but no crash). r)referenced_skill_namesz0Curator could not read cron skill references: %sTr_N) cron.jobsrrarSrTset)_refsrZs r_cron_referenced_skillsr"s<=w  GUY Zu s  A!?AAcddlm}|#tjtj }|t tz }|t tz }t}dddddd}|jD]}|dxxdz cc<|d}|jdr(||vr-|jd d s|j||d xxdz cc<^t|jd }|xst|jd xs|} | j | jtj } |jd|j } t#|jddxsddk(} | r?| |kDr:| |j$k(r)|j'||j |dxxdz cc<E| |kr6| |j(k7r'|j+|\} } | sq|dxxdz cc<| |kr:| |j k(r+|j'||j$|dxxdz cc<| |kDs| |j$k(s|j'||j |dxxdz cc<|S)u.Walk every curator-managed skill and move active/stale/archived based on the latest real activity timestamp. Pinned skills are never touched. Built-ins (eligible only when ``curator.prune_builtins`` is on) are seeded with a baseline record the first time they're seen so their inactivity clock starts NOW rather than at epoch — a long-unused built-in is therefore archived only after a fresh ``archive_after_days`` of non-use, not on the first pass after the flag flips on. Returns a counter dict describing what changed. rr)days) marked_stalearchived reactivatedcheckedseededrnamepinned _persistedTrlast_activity_at created_atrrf use_countrrr)toolsrrrrrrrrragent_created_reportr0seed_record_if_missingrrr STATE_ACTIVEry STATE_STALE set_stateSTATE_ARCHIVED archive_skill)r_u stale_cutoffarchive_cutoffcron_referencedcountsrowr last_activityanchorcurrent never_usedok_msgs rapply_automatic_transitionsr1sK( {ll8<<((<(>??L9*@*BCCN-/OQqQZ[ \F&&(5'yQ6{ 778   ? " ww|T*  % %d + 8  !  "377+=#>? J*SWW\-B"CJs == ^^8<<^8F'''2??3 a05A6!; &</"..( T2??3}%*%  ^ #23D3D(D''-HBz"a'" | #2??(B LLr~~ . > "a ' " l "w"..'@ LLr / = !Q & !k5'n Mru═══════════════════════════════════════════════════════════════ DRY-RUN — REPORT ONLY. DO NOT MUTATE THE SKILL LIBRARY. ═══════════════════════════════════════════════════════════════ This is a PREVIEW pass. Follow every instruction below EXCEPT: • DO NOT call skill_manage with action=patch, create, delete, write_file, or remove_file. • DO NOT call terminal to mv skill directories into .archive/. • DO NOT call terminal to mv, cp, rm, or rewrite any file under ~/.hermes/skills/. • skills_list and skill_view are FINE — read as much as you need. Your output IS the deliverable. Produce the exact same human-readable summary and structured YAML block you would produce on a live run — but describe the actions you WOULD take, not actions you took. A downstream reviewer will read the report and decide whether to approve a live run with `hermes curator run` (no flag). If you accidentally take a mutating action, say so explicitly in the summary so the reviewer can revert it. ═══════════════════════════════════════════════════════════════u!You are running as Hermes' background skill CURATOR. This is an UMBRELLA-BUILDING consolidation pass, not a passive audit and not a duplicate-finder. The goal of the skill collection is a LIBRARY OF CLASS-LEVEL INSTRUCTIONS AND EXPERIENTIAL KNOWLEDGE. A collection of hundreds of narrow skills where each one captures one session's specific bug is a FAILURE of the library — not a feature. An agent searching skills matches on descriptions, not on exact names; one broad umbrella skill with labeled subsections beats five narrow siblings for discoverability, not the other way around. The right target shape is CLASS-LEVEL skills with rich SKILL.md bodies + `references/`, `templates/`, and `scripts/` subfiles for session-specific detail — not one-session-one-skill micro-entries. Hard rules — do not violate: 1. DO NOT touch bundled, hub-installed, or external-dir skills (`skills.external_dirs`). The candidate list below is already filtered to local curator-managed skills only; external skills are externally owned and read-only to this background curator. 2. DO NOT delete any skill. Archiving (moving the skill's directory into ~/.hermes/skills/.archive/) is the maximum destructive action. Archives are recoverable; deletion is not. 3. DO NOT touch skills shown as pinned=yes. Skip them entirely. 3b. DO NOT archive, delete, consolidate, move, or otherwise modify any skill named in the protected built-ins list (currently: plan). These back load-bearing UX (slash-command entry points referenced in docs and tips) and are filtered out of the candidate list below — never resurrect one as an archive or absorb target. 3c. DO NOT archive or prune any skill marked `cron=yes` in the candidate list. A cron job depends on it and will fail to load it on its next run. You MAY still consolidate it into an umbrella — but only because the curator rewrites cron job skill references to follow consolidations; never simply prune it. 4. DO NOT use usage counters as a reason to skip consolidation. The counters are new and often mostly zero. Judge overlap on CONTENT, not on use_count. 'use=0' is not evidence a skill is valuable; it's absence of evidence either way. Corollary: 'use=0' is ALSO not a reason to PRUNE a skill. Never archive a never-used skill (use=0) unless it is at least 30 days old (check last_activity / created date) AND its content is genuinely obsolete or fully absorbed elsewhere — a recently-created skill simply may not have had its trigger come up yet. 5. DO NOT reject consolidation on the grounds that 'each skill has a distinct trigger'. Pairwise distinctness is the wrong bar. The right bar is: 'would a human maintainer write this as N separate skills, or as one skill with N labeled subsections?' When the answer is the latter, merge. How to work — not optional: 1. Scan the full candidate list. Identify PREFIX CLUSTERS (skills sharing a first word or domain keyword). Examples you are likely to find: hermes-config-*, hermes-dashboard-*, gateway-*, codex-*, ollama-*, anthropic-*, gemini-*, mcp-*, salvage-*, pr-*, competitor-*, python-*, security-*, etc. Expect 10-25 clusters. 2. For each cluster with 2+ members, do NOT ask 'are these pairs overlapping?' — ask 'what is the UMBRELLA CLASS these skills all serve? Would a maintainer name that class and write one skill for it?' If yes, pick (or create) the umbrella and absorb the siblings into it. 3. Three ways to consolidate — use the right one per cluster: a. MERGE INTO EXISTING UMBRELLA — one skill in the cluster is already broad enough to be the umbrella (example: `pr-triage-salvage` for the PR review cluster). Patch it to add a labeled section for each sibling's unique insight, then archive the siblings. b. CREATE A NEW UMBRELLA SKILL.md — no existing member is broad enough. Use skill_manage action=create to write a new class-level skill whose SKILL.md covers the shared workflow and has short labeled subsections. Archive the now-absorbed narrow siblings. c. DEMOTE TO REFERENCES/TEMPLATES/SCRIPTS — a sibling has narrow-but-valuable session-specific content. Move it into the umbrella's appropriate support directory: • `references/.md` for session-specific detail OR condensed knowledge banks (quoted research, API docs excerpts, domain notes, provider quirks, reproduction recipes) • `templates/.` for starter files meant to be copied and modified • `scripts/.` for statically re-runnable actions (verification scripts, fixture generators, probes) Then archive the old sibling. Use `terminal` with `mkdir -p ~/.hermes/skills//references/ && mv ... /references/.md` (or templates/ / scripts/). Package integrity — not optional: Before demoting or archiving a skill, inspect it as a COMPLETE directory package, not just SKILL.md. A skill root may include `references/`, `templates/`, `scripts/`, and `assets/`; `skill_view` discovers those relative to the skill root. A reference markdown file inside another skill is NOT a new skill root and does not get its own linked-file discovery. If the source skill has support files OR SKILL.md contains relative links such as `references/...`, `templates/...`, `scripts/...`, or `assets/...`, DO NOT flatten only SKILL.md into `/references/.md`. Choose one safe path instead: • keep it as a standalone skill, OR • fully merge it by re-homing every needed support file into the umbrella's canonical `references/`, `templates/`, `scripts/`, or `assets/` directories AND rewrite the destination instructions to the new paths, OR • archive the entire original skill package unchanged. Never leave archived/demoted instructions pointing at files that were left behind under the old skill directory. 4. Also flag skills whose NAME is too narrow (contains a PR number, a feature codename, a specific error string, an 'audit' / 'diagnosis' / 'salvage' session artifact). These almost always belong as a subsection or support file under a class-level umbrella. 5. Iterate. After one consolidation round, scan the remaining set and look for the NEXT umbrella opportunity. Don't stop after 3 merges. Your toolset: - skills_list, skill_view — read the current landscape - skill_manage action=patch — add sections to the umbrella - skill_manage action=create — create a new umbrella SKILL.md - skill_manage action=write_file — add a references/, templates/, or scripts/ file under an existing skill (the skill must already exist) - skill_manage action=delete — archive a skill. MUST pass `absorbed_into=` when you've merged its content into another skill, or `absorbed_into=""` when you're truly pruning with no forwarding target. This drives cron-job skill-reference migration — guessing from your YAML summary after the fact is fragile. - terminal — move LOCAL candidate content into a support subfile when package integrity requires it; never mv, cp, rm, patch, or rewrite bundled, hub-installed, or external-dir skills 'keep' is a legitimate decision ONLY when the skill is already a class-level umbrella and none of the proposed merges would improve discoverability. 'This is narrow but distinct from its siblings' is NOT a reason to keep — it's a reason to move it under an umbrella as a subsection or support file. Expected output: real umbrella-ification. Process every obvious cluster. If you end the pass with fewer than 10 archives, you stopped too early — go back and look at the clusters you left alone. When done, write a human summary AND a structured machine-readable block so downstream tooling can distinguish consolidation from pruning. Format EXACTLY: ## Structured summary (required) ```yaml consolidations: - from: into: reason: prunings: - name: reason: ``` Every skill you moved to .archive/ MUST appear in exactly one of the two lists. If you consolidated X into umbrella Y (patched Y, wrote a references file to Y, or created Y with X's content absorbed), X goes under `consolidations` with `into: Y`. If you archived X with no absorption — truly stale, irrelevant, or obsolete — X goes under `prunings`. Leave a list empty (`consolidations: []`) if none. Do not omit the block. The block comes AFTER your human-readable summary of clusters processed, patches made, and decisions left alone.ctdz dz } |jdd|S#t$r!}tj d|Yd}~|Sd}~wwxYw)uxDirectory where curator run reports are written. Lives under the profile-aware logs dir (``~/.hermes/logs/curator/``) alongside ``agent.log`` and ``gateway.log`` so it's found by anyone looking for operational telemetry, not mixed in with the user's authored skill data in ``~/.hermes/skills/``. ``ensure_hermes_home()`` pre-creates this dir on every CLI launch and the v22→v23 migration backfills it for existing profiles, but we still mkdir here as a belt-and-suspenders so the curator works even from an odd entry path (e.g. gateway-only install, bare library use) that bypasses both. logsrmTparentsexist_okz%Curator reports dir create failed: %sN)rmkdirrQrSrT)rootrZs r _reports_rootr?s^  v % 1DA 4$ / K A ^ + ff[!'R! c4 D S ! %zz# $% D!'"0{#c%+2&66L>* ""&c3/c31GH 0 DXXf%Ffc*&~\)02IU /HHSMa%$$c1X. /C% S%F! k)";FC"H"&IIBIIf,=+>b&A3G#"2488Hc3J2KL##)(.?""%cr(-! !"' (a0 d    t R S MM64. )}>*@)F ;;[ %} %s1H.. H?>H?c ggd}|rt|ts|Sddl}|jd||j|j z}|s|S|j d} ddl}|j|}t|ts|Sggd}|jdxsg}|jdxsg} t|tr|D]} t| ts| jd} | jd } t| tr0| jr t| tr| jsw| jd } |dj| j| jt| tr| xsd jnd d t| tr| D]} t| ts| jd }t|tr|jsF| jd } |dj|jt| tr| xsd jnd d|S#t$r|cYSwxYw)uiExtract the structured YAML block from the curator's final response. The curator prompt requires a fenced ```yaml block under ``## Structured summary (required)`` with ``consolidations:`` and ``prunings:`` lists. This parses it tolerantly: - Missing block → returns empty lists (we'll fall back to heuristic). - Malformed YAML → returns empty lists and we rely on heuristic. - Partial block (e.g. only consolidations) → returns what we could parse. Returns ``{"consolidations": [{"from", "into", "reason"}, ...], "prunings": [{"name", "reason"}, ...]}``. )consolidationspruningsrNz```ya?ml\s*\n(.*?)\n```rrrfromrreasonr)rrr r)rr )r/rrrDOTALL IGNORECASEgroupyaml safe_loadrar.r0listrr) llm_finalemptyrmatchbodyr rVoutcons_rawprun_rawentryfrmrr rs r_parse_structured_summaryrs* "r 2E Jy#6  BII" BMM! E  ;;q>D~~d# dD ! >@b+QCxx()/RHxx #)rH(D! EeT*))F#C99V$DsC(SYY["4-$**,YYx(F  ! ( (  4>vs4K6vs4K6`` when consolidating, or ``absorbed_into=""`` when truly pruning. This is the single authoritative signal for classification — the model's own declaration at the moment of deletion, which beats both post-hoc YAML summary parsing and substring heuristics on other tool calls. Returns ``{skill_name: {"into": "" | "", "declared": True}}``. Entries with ``into == ""`` are explicit prunings. Skills without a ``skill_manage(delete)`` call, or with one that omitted ``absorbed_into``, are not in the returned dict — caller falls back to the existing heuristic/YAML logic for those (backward compat with older curator runs and any callers that don't populate the arg). rrrrrdelete absorbed_intoT)rdeclared)r/r.r0rrLrMrar)rrrrrrrs r#_extract_absorbed_into_declarationsr2s.&&(CBG"d#  66&>^ + ff[!'R! c4 D S ! zz#$%  88H  ) xx$$DJJL  $ & /* > &#& %+\\^FDJJL=G> J'  s.D.. D;:D;c h|jdgDcic]}|d| }}|jdgDchc]}|d }}|jdgDcic]}|d| }}|jdgDcic]}|d| } }|xsi} g} g} |D]} |j| }| j| }|j| }| j| }||jdd}|rO||vrK| |d |r|jd xsdndd }|r|jd r|d |d <| j||dk(r-| j| d |r|jd xsdndd|re|jd|vrR| |dd|rdndz|jd xsdd }|r|jd r|d |d <| j|F|r[|jd|vrH|r/| j| |ddd|jd d|ddn| j| ddd|r,| j| |ddd|jd dd|r|jd dnd}| j| |rdnd|d| | dScc}wcc}wcc}wcc}w)uLMerge heuristic (tool-call evidence) with the model's structured block. Rules (evaluated in order; first match wins): - **Model-declared `absorbed_into` at delete time is authoritative.** Any entry in ``absorbed_declarations`` beats every other signal. This is the model telling us directly, at the moment of deletion, what it did. ``into != ""`` and target exists → consolidated. ``into == ""`` → pruned. ``into != ""`` but target doesn't exist → hallucination; fall through to the usual signals. - Model-declared consolidation wins when its ``into`` target exists in ``destinations`` (survived or newly-created). This gives the model authority over intent + rationale. - Model-declared consolidation whose ``into`` target does NOT exist is downgraded: the model hallucinated an umbrella. We prefer the heuristic's finding for that skill, or fall back to pruned. - Heuristic-only finding (model didn't mention it, tool calls confirm) is preserved as a consolidation, marked ``source="tool-call audit"``. - Model-declared pruning is accepted unless the heuristic has tool-call evidence that contradicts it (rare — the heuristic would have flagged consolidation). In that case we log both. Every removed skill is placed in exactly one bucket. rrrrrrrrz(absorbed_into (model-declared at delete)r )rrsourcer rz'absorbed_into="" (model-declared prune))rr r r z+auditz.tool-call audit (model named missing umbrella))rrr r rmodel_claimed_intoz>fallback (model named missing umbrella, no tool-call evidence)z5tool-call audit (model omitted from structured block))rrr r rzno-evidence fallbackr)r0r)r heuristic model_blockrabsorbed_declarationsrZ heur_cons heur_pruned model_cons model_prunedrrrrmcmphcdec into_claimrr s r_reconcile_classificationr.hs<(1}}^R'HI!6AIII&/mmHb&AB1V9BKB(38H"(MN1!F)Q,NJN*5//*b*IJQAfIqLJLJ$*H)+L#%FU  ^^D !   d # ]]4 ll4  ?,JjL8 &H:wiH  99U uThRsH*H* H/$H/cT t} |jdd|j d} || z } d} | j r | dz } || d| z } | j r | jdd|D cic]%} t| ts| jd | '}} t|j}t||z }t||z }|D cic]%} t| ts| jd | '}} g}t||zD]k}|j|xsijd }|j|xsijd }|sN|sQ||k7sW|j|||d mi}|jd gxsgD],}|jd d}|j|ddz||<.t||||jd gxsg}t|jddxsd}t|t|xsgz}t!|jd gxsg}t#|||||}|d}|d}gddd} |D cic]=} t| tr+| jd r| jdr | d | d?}!} |D cgc](} t| tr| jd r| d *}"} |!s|"rddlm}#|#|!|"} id|j+dt-|dd |jd dd!|jd!dd"|d#t/|t/|t/|t/|z t/|t/|t/|t/|t/|t1| jd$dt3|j5d% d&|d'|d|d|d(|D$cgc]}$|$d  c}$d)|d*|d+| d,|jddd-|jd.dd/|jd0d |jd gi}% | d1z j7t9j:|%dd2d3zd45 t=|%}&| d7z j7|&d45 t1| jd$ddkDr/| d9z j7t9j:| dd2d3zd45| S#t$r } tj d| Yd} ~ yd} ~ wwxYw#t$r } tj d | Yd} ~ yd} ~ wwxYwcc} wcc} wcc} wcc} w#t$r3} tj d| dgddt)| d} Yd} ~ d} ~ wwxYwcc}$w#t$r!} tj d6| Yd} ~ Gd} ~ wwxYw#t$r!} tj d8| Yd} ~ Rd} ~ wwxYw#t$r!} tj d:| Yd} ~ | Sd} ~ wwxYw);uWrite run.json + REPORT.md under logs/curator/{YYYYMMDD-HHMMSS}/. Returns the report directory path on success, None if the write couldn't happen (caller logs and continues — reporting is best-effort). Trz$Curator report dir create failed: %sNz %Y%m%d-%H%M%SrrFz!Curator run dir create failed: %srrf)rrtorunknownrr0finalrr1rr)rewrites jobs_updated jobs_scannedr)rewrite_skill_refsrz%Curator cron skill rewrite failed: %sr_)rJrKrLerror started_atduration_secondsr7r rauto_transitionsrrK) beforeafterdeltaarchived_this_runadded_this_runconsolidated_this_runpruned_this_runstate_transitionscron_jobs_rewrittentool_calls_totaltool_call_countsr pruned_namesrrY cron_rewritesr llm_summarysummary llm_errorrNzrun.json)r] ensure_asciir4rGrHz!Curator run.json write failed: %sz REPORT.mdz"Curator REPORT.md write failed: %szcron_rewrites.jsonz+Curator cron_rewrites.json write failed: %s)rrrarSrTstrftimerKr/r.r0rr5r6rrrrr.rrMrrroundr7rysumvalues write_textrLdumps_render_report_markdown)'rOelapsed_seconds auto_counts auto_summary before_reportr9r:llm_metarrZstamprun_dirsuffixr<r=rrrbefore_by_name transitionsrs_befores_after tc_countsrr"r#rr$r>rrr^consolidated_mapr]_rewrite_cron_refsppayloadmds' r_write_run_reportr|Es ?D 4$ /    0EUlG F .. ! E7!F8,, ..  dU 3 0<S!z!T?RQUU6]A%SMSm((*+K\K/0G ;- .E0=U1AtATaeeFmQ&UNU)+K{\12P"&&t,277@ $$T*0b55g> H$7   hgN O P!#Ill<,25vvfi(#--a014 $5$)<< b17R I ,HLL",E,KLK{#c%+2&66L @ \2&,"/!3 N".1L H %F24QXY$ZM " !T"quuV}v fIqy   & !T"quuV} fI   | J.-#Mj**,E/15 gr* HLLR0  K  ,'%%L(99!$W!%j%(%6"6{!$[!1#&}'8'8'K#L #I$4$4$6 7  $ I%& G'(  )* &+, F3q63-. /0 [12 34 X\\'2.56 x||Ir278 X\\'*9: hll<4;GB= : )) JJwqu = D * > $W - ; **2*@ G }  3 4q 8 + + 7 7 =G$N  8  NU  ;Q?  8!< TVB     4 = 8!<<= > 91==> G BAFF NGsS3(T?U U $U:U2U6AU8U>-U+U, V/V#!W$A W=3 T<TT U(UU U V((VV# W ,WW  W:W55W:= X'X""X'cfg}|jdd}|jddxsd}tt|d\}}|r|d|dn|d}|jd|d |jd xsd }|jd xsd }|jd xsi} |jd|d|d|d| jddd| jddd| jdddd |jd} | r|jd| d|jdxsi} |jd|jd| jdd|jd | jd!d|jd"| jd#d|jd$| jd%d|jd|jd&xsi} |jd'|jd(| jd)dd*d+j d,t | j Dxsd-d.|jd/| jd0dd1|jd2| jd3dd1|jd4| jd5dd1|jd6| jd7dd1|jd|jd8xsg} | r>|jd9t| d|jd:d;}| d<|D]}|jd=d>}|jd?d>}|jd@xsdj}|jdAd}dB|dC|dD}|r|dE|z }|r|jdFr |dG|dHz }|j||jdIs|jdJ|dIdKt| |kDr!|jdLt| |z dM|jd|jdNxsg}|r|jdOt|d|jdPd;}|d<|D]~}t|trW|jd=d>}|jd@xsdj}dB|dD}|r|dE|z }|j|j|jdB|dDt||kDr!|jdLt||z dM|jd|jdQxsg}|r\|jdRt|d|jdS|D]}|jdB|dD|jd|jd7xsg}|r}|jdTt|d|D]I}|jdB|jd=dU|jdVd|jdWK|jd|jdXxsi}|jdYxsg}|r|jdZt|d|jd[d\}|d<|D]}|jd]xs|jd^xsd>}|jdxsg}|jdxsg}|jd_xsi}|jd`xsg} |jdB|dad+j |dbd+j |xsdcdD|j D]\}!}"|jdd|!db|"de| D]}|jdd|df t||kDr!|jdLt||z dg|jd|jdhxsdj}#|#r4|jdi|j|#|jdnL| sJ|jdjxsd}$|$r3|jdk|j|$|jd|jdl|jdm|jdn|jdo|jdd j |S)pz!Render the human-readable report.rOrrPr<zm su# Curator run — r4r z(not resolved)rrzModel: `z` via `u` · Duration: u · Agent-created skills: rRr3rSz (rTz+dz) rau> ⚠ LLM pass error: `z` rQz### Auto-transitions (pure, no LLM) z - checked: rz- marked stale: rz0- archived (no LLM, pure time-based staleness): rz- reactivated: rr\z## LLM consolidation pass z- tool calls: **r[z ** (by name: , c30K|]\}}|d|yw)=Nr+).0rXrYs r z*_render_report_markdown..(s'Ytq!1#Qqc 'Ysnone)z!- consolidated into umbrellas: **rWz**z%- pruned (archived for staleness): **rXz- new skills this run: **rVu7- state transitions (active ↔ stale ↔ archived): **rYrz'### Consolidated into umbrella skills (u$_These skills were **absorbed into another skill** during this run — their content still lives, just under a different name. The original directory was moved to `~/.hermes/skills/.archive/` for safety and can be restored via `hermes curator restore ` if the consolidation was wrong._ 2Nrrrr r z- `u` → merged into ``u — ztool-call auditz _(detected via z)_r!u# ⚠ The curator's summary named `zg` as the umbrella but that skill doesn't exist post-run; showing the tool-call audit's finding instead.u - … and z more (see `run.json`)ru'### Pruned — archived for staleness (z_These skills were archived without being merged into an umbrella (e.g. stale, unused, or judged irrelevant). Directories live under `~/.hermes/skills/.archive/`. Restore any via `hermes curator restore `._ rz### New skills this run (zX_Usually these are new class-level umbrellas created via `skill_manage action=create`._ z### State transitions (z`: rrGr^rJz)### Cron job skill references rewritten (z_Cron jobs that referenced a consolidated or pruned skill were updated in-place so they keep loading the right instructions on their next run. See `cron_rewrites.json` for the full record._ job_namejob_idmappeddroppedz`: `u` → `z(none)z - `z` (consolidated)z` dropped (pruned)z more (see `cron_rewrites.json`)rz## LLM final summary r_z## LLM summary z ## Recovery z<- Restore an archived skill: `hermes curator restore `zR- All archives live under `~/.hermes/skills/.archive/` and are recoverable by `mv`zH- See `run.json` in this directory for the full machine-readable record.) r0divmodryrr8r6rOr7rrPr/r.)%ryr@starteddurationminssecs dur_labelr provrrNautorvrr?rrrr r linerrntranstcron_rwcron_rewrites_listrrRrSrroldnewrIllm_sums% rriris- EeeL"%Guu'+0qHH r*JD$&*4&4&"4& I LL%gYb12 EE'N ..E 55  0 0D UU8_ "F LL 5'&7 {C!!'Ha!8 9vzz'ST?U>VW JJw "2 &c + EE+ E  .ugS9: 55# $ *D LL78 LL;txx 15678 LL#DHH^Q$?#@AB LLCDHHZYZD[C\]^ LL?488M1#=">?@ LL()/RI LL./ LL#FJJ/A1$E#FG"ii'YviooFW?X'YYc]cddegh LL4VZZ@WYZ5[4\\^_` LL8DUWX9Y8ZZ\]^ LL,VZZ8H!-L,MRPQ LLjj!4a89=> LL 55(.BL >sQQTUV  * !%4( E99VS)D99VS)Dii)/R668FYYx,F1$q9D%x((&++,=>+F8266 LL yy-. 9%@T:U9VWEE & | t # LL:c,&7$&>%??UV W RUU8_ "F  >s6{m3OP  B ET] -E%&yy-))H-3::<TF!}eF8,,D T" s5'^, - v;  LL:c&kD&8%99OP Q R EE'N bE  0U C@A pq %A LL3qc $ % R EE% & ,"E  .s5zl#>? TA LL3quuV}oSvuQUU4[MR S T R eeO$*G Z06B @EWAX@YY\]^  R '. AEyy,J (0CJsHYYx(.BFIIg&,"EYYx(.BFii *0bG LLhZtDIIf$5#6gdii>N>ZRZ=[[\] #LLN JS wse73%7GHI J A wtf,>?@ A A ! "T ) LLS!34t;<=--   RUU;  %2 , , .E  -. U R %% &,"  LL+ , LL ! LL  LL! LLOP LLef LL[\ LL 99U rctj}|syt}dt|dg}|D]}|j d|dd|dd|j d rd nd d |d|vrd nd d |j ddd|j ddd|j ddd|j ddd|j dxsddj |S)zCHuman/agent-readable list of agent-created skills with usage stats.z"No agent-created skills to review.zAgent-created skills (z): z- rz state=rfz pinned=ryesnoz cron=z activity=activity_countrz use=rz view= view_countz patches= patch_countz last_activity=rneverr4)rrrr7rr0r8)rowsrr@r<s r_render_candidate_listrs!  + + -D 3-/O%c$i[ 5 6E    6 wZL! uuXeD9:vY/9EtDE.23455a()*EE,*+,uu]A./0UU#56A'B D    99U rc  ttjtjr& t j }t|dddd n@ ddl m }|jd}|r d|jdt  g} d r|j! d d dr|j! dd dr|j! dd|rdj#|nd t%} s4j'| d<t)| j+dddz| d<rdnd | d<t-|   fd} |r| n(t/j0| d d} | j3j' dS#t$r ddddd Y)wxYw#t$rYEwxYw#t$r#}tjd |d Yd}~pd}~wwxYw)uExecute a single curator review pass. Steps: 1. Apply automatic state transitions (pure, no LLM). 2. If consolidation is enabled AND there are agent-created skills, spawn a forked AIAgent that runs the LLM review prompt against the current candidate list. 3. Update .curator_state with last_run_at and a one-line summary. 4. Invoke *on_summary* with a user-visible description. If *synchronous* is True, the LLM review runs in the calling thread; the default is to spawn a daemon thread so the caller returns immediately. *consolidate* gates the LLM umbrella-building pass. ``None`` (the default) reads ``curator.consolidate`` from config (OFF by default). Passing ``True``/``False`` overrides the config for this invocation — used by the ``hermes curator run --consolidate`` flag. When consolidation is off, only the deterministic inactivity prune runs and the forked aux-model review is skipped entirely (no aux-model cost). If *dry_run* is True, the automatic stale/archive transitions are SKIPPED and the LLM review pass is instructed to produce a report only — no skill_manage mutations, no terminal archive moves. The REPORT.md still gets written and ``state.last_report_path`` still records it so users can read what the curator WOULD have done. A dry-run also honors *consolidate*: when consolidation is off, the preview only reports the deterministic prune candidates. Nr)rrrr)curator_backupzpre-curator-run)r zcurator: snapshot created (rz#Curator pre-run snapshot failed: %sTr_)rrz marked stalerz archivedrz reactivatedrz no changesr>rDrzdry-run auto: zauto: r@c   tj}|Dchc]$}t|ts|j d&}}sd}ddddgdd}t jtjz j}t}||d<||d< tj} t|||||}|t||d <t!|r d |yyi} t#} d| vrd}ddddgdd}nVd} t%rd} rt&dt(| d| } n t(| d| } t+| }d|j dd} t-|tj|j dgxsg|j ddxsd} | r|d| }t jtjz j}t}||d<||d< tj} t|||||}|t||d <t!|r d |yy#t$rg}YRwxYwcc}w#t$rg}YwxYw#t$r#} tjd | d Yd} ~ d} ~ wwxYw#t$rYywxYw#t$rC} tjd| d d| d}dd| dddgt| d}Yd} ~ d} ~ wwxYw#t$r#} tjd| d Yd} ~ yd} ~ wwxYw#t$rg}Y2wxYw#t$r#} tjd | d Yd} ~ 9d} ~ wwxYw#t$rYywxYw)Nrz"; llm: skipped (consolidation off)rzskipped (consolidation off)rIr`r rrrNr?r@)rOrjrkrlrmr9r:rnrBzCurator report write failed: %sTr_z curator: zNo agent-created skillsz; llm: skipped (no candidates)zskipped (no candidates)a PRUNE-BUILTINS MODE IS ON: bundled built-in skills ARE included in the candidate list below and MAY be archived for staleness/irrelevance, overriding hard rule #1 for bundled skills ONLY. Hub-installed skills remain strictly off-limits. Treat a stale built-in the same as a stale agent-created skill: archive it (never delete). It will be restored on `hermes update` only if the user explicitly restores it.z z; llm: r` no changezCurator LLM pass failed: %sz; llm: error (rzerror (rrI)r9r:rr;r4z'Curator rename summary build failed: %s)rrrar/r.r0rrrr total_secondsr[r|rrSrTrbrrCURATOR_DRY_RUN_BANNERCURATOR_REVIEW_PROMPT_run_llm_reviewrE)rmr<r9 final_summaryrnelapsedstate2r: report_pathrZcandidate_list builtins_noteprompt rename_linesrlrrdry_run on_summaryprefixstarts r _llm_passz%run_curator_review.._llm_pass/sL '<<>M0=T! 1d@Sf T T (<.(JK 8  H ||HLL1E9HHJG\F29F. /)6F% & "*??A  R/$$+ &!-"/!-!-%  *14[1AF-. v =/:; #%3 35N(N:#)(<.8V W 8 ""$! !# %';"12$01-)*, !66}oT.IYZF*62h|nGHLLK4X3YZ& V0)(==?#<< b9?R$LL"5; L #0/L> B << -5DDF.5*+%2!"  &;;=L N+ '")+))! K&-0-=)* 6  Y}o67 o M T0 "!  " R >D QQ R ! \  LL6DL I%h|nN1#QGM$QCq> Q H 2 V LLBAPTL U U V L  N LL:AL M M N  sII-I-!I26#J' J37A5K-ALM#M N I*)I*2 JJ J0 J++J03 J?>J? L 8L  L L=L88L= MM M>M99M> N  N zcurator-review)rdaemonr)rOrQsummary_so_far)rrrrrrrr7raagentrsnapshot_skillsrrSrTrrr8r[rryr0rb threadingThreadr)r synchronousrrreportrsnaprZauto_summary_partsrfrrrlrrrs` `` @@@@rrun_curator_reviewrs2D%' LL &E X 557Fv; ! F R ,!119J1KDJ!DL Q Q RsG$F5 G=G 5G G  GGGG H%HHc Pt|jdtr|jdini}|jdxsd}|jdxs|jdxsd}t|jdtr|jdini}t|jdtr|jdini}|jdxsdjxsd}|jdxsdjxsd}|r_|dk7rZ|rXt ||t |jd t |jd t i|jd St|jdtr|jdini}t|jdtr|jdini} | jdxsd} | jdxsd} | r| rtjd t t| t| t | jd t | jd t i| jd St ||ddiS) abResolve provider/model and per-slot credentials for the curator review fork. Same precedence as `_resolve_review_model()`. Non-empty ``api_key`` / ``base_url`` from the active slot are returned as explicit overrides so ``resolve_runtime_provider`` does not silently reuse the main chat credential chain for a routed auxiliary model. r rrdefaultr auxiliaryrmNapi_keybase_urlr-u|curator: using deprecated curator.auxiliary.{provider,model} config — please migrate to auxiliary.curator.{provider,model}) r/r0r.rrrr5rSinfor) ro_main_main_provider _main_model_aux _cur_task_task_provider _task_model_cur_legacy_legacy_provider _legacy_models r_resolve_review_runtimers1%/swww/?$FCGGGR BEYYz*4fN))I&B%))G*<BK(2#''+2F'M377; #SUD+5dhhy6I4+PB'VXImmJ/52<<>F$N==)/R668@DK.F2{$   !)-- ": ; !)-- "; < $R|)D E   &0 0BD%I3779b !rD+5dhh{6KT+Rdhh{B'XZG{{:.6$KK(0DMM  N %  !   !'++i"8 9 !'++j"9 : $R\)B C    !dD" MMrcHt|}|j|jfS)u*Pick (provider, model) for the curator review fork. Curator is a regular auxiliary task slot — ``auxiliary.curator.{provider,model}`` — so it participates in the canonical aux-model plumbing (``hermes model`` → auxiliary picker, the dashboard Models tab, ``auxiliary.curator.{timeout, base_url,api_key,extra_body}``). ``provider: "auto"`` with an empty model means "use the main chat model" — same default as every other aux task. Legacy fallback: users who configured ``curator.auxiliary.{provider,model}`` under the previous one-off schema still work. Precedence: 1. ``auxiliary.curator.{provider,model}`` when both are set non-auto 2. Legacy ``curator.auxiliary.{provider,model}`` when both are set 3. Main ``model.{provider,default/model}`` pair )rrr )robs r_resolve_review_modelrs! $A ::qww rc 6 ddl}ddddgdd} ddlm}d}d}d}d}d} i} d} d} d} d} dd lm}dd lm}|}t|}|j|j}}||||j|j }|jd }|jd }|jd}|jdxs|}|jd} t|jd|jjd} |jd} |jd} t!|jdxsg} t#|jdt$r&|dj'r|dj'}||d<|xsd|d<d} i}t#| t,r| |d<t#| t$r| r| |d<| xsg|d<|d3|||||| | d|dddddd }d|_d|_d!|_t5t6j8d"d#$5}|j;|5|j=|5|j?|%}dddddddddd}t#t@r,t%|jd&xsdj'}||d'<tC|d(kDr|dd(d)zn|xsd*|d<g}tE|d+gxsgD]}t#|t@s|jd,xsg}|D]}t#|t@s|jd-xsi}|jd.xsd}|jd/xsd} t#| t$rtC| d0kDr| dd0d)z} |jG|| d1||d,<| |jI|S|S#t$r}d||d<|d|d<|cYd}~Sd}~wwxYw#t$r#}t(j+d|dYd}~|d}~wwxYw#1swYxYw#1swYxYw#1swYxYw#t$r}d2||d<|d|d<Yd}~d}~wwxYw#t$rY|SwxYw#|! |jIw#t$rYwwxYwwxYw)4a/Spawn an AIAgent fork to run the curator review prompt. Returns a dict with: - final: full (untruncated) final response from the reviewer - summary: short summary suitable for state file (240-char cap) - model, provider: what the fork actually ran on - tool_calls: list of {name, arguments} for every tool call made during the pass (arguments may be truncated for readability) - error: set if the pass failed mid-run; final/summary may still be empty Never raises; callers get a structured failure instead. rNrr)AIAgentzAIAgent import failed: rNr`rk)resolve_runtime_provider) requested target_modelr"r#rrapi_modercredential_poolr%r-max_output_tokenscommandrr z&Curator provider resolution failed: %sTr_ max_tokens acp_commandacp_args)r rrrrrr%i'rm)max_iterations quiet_modeplatformskip_context_files skip_memorybackground_reviewwrGrH) user_messagefinal_responserIu…r_session_messagesrfunctionrri)rrzerror: r+)% contextlib run_agentrrarnrlhermes_cli.runtime_providerrrrr r"r#r0r5r%rr/rrrSrTry_memory_nudge_interval_skill_nudge_interval_memory_write_originopenosdevnullredirect_stdoutredirect_stderrrun_conversationr.r7getattrrclose)!rr result_metarrZ_api_key _base_url _api_mode_resolved_provider_credential_pool_request_overrides _max_tokens _acp_command _acp_args _model_namerlr_cfg_binding _provider_rp review_agent _agent_kwargs_devnull conv_resultrI_callsmsgtcsrfnrargs_raws! rrr!s4 #K%"HII)+KLIKQ1H}*40!)!2!2HNN; &$%66&88   779%GGJ' GGJ'  WWZ0=I77#455 GG' (  & & * *< 8 gg12 wwy) .B/ cggg& ,W1C1C1Eg,,,.K'K06BK LR(* k3 '*5M, ' lC (\+7M- ((1RM* % ',0   #% */0 +-. *-@ )"**cG 4 M  ' ' 1 M  ' ' 1 M'77V7LK M M M  k4 ( (89?R@FFHE$ G:=e*s:J%+"5QVQeZe I (*<)P=+Q#? O$OO$O$' P0PPP P##P- (P00P:5P== Q QQ3Q  Q3# Q0/Q03R7RR RRRR)idle_for_secondsrc tsy|tdz}||kryt|S#t$r"}tj d|dYd}~yd}~wwxYw)z~Best-effort: run a curator pass if all gates pass. Returns the result dict if a pass was started, else None. Never raises.Ng @)rzmaybe_run_curator failed: %sTr_)rrrrarSrT)rr min_idle_srZs rmaybe_run_curatorrs_   '+-6J*,!Z88  3Q Fs .. . AAA)rrreturnr!)r2rr3rr r$)r r)r r$)rVr$r None)rCrer r!)r re)r ry)r r)rr!r Optional[datetime]r)rr"r re)r Set[str])rr"r Dict[str, int])rrrUrr re) r List[str]rr%rr#rList[Dict[str, Any]]r Dict[str, List[Dict[str, Any]]])rrr Dict[str, List[Dict[str, str]]])rr&r zDict[str, Dict[str, Any]]) rr%r"r'r#r(rr#r$z#Optional[Dict[str, Dict[str, Any]]]r r') r9r#r:r&rr&r;rr r)rOrrjrrkr$rlrrmr&r9r#r:r&rnr$r zOptional[Path])ryr$r r)r r)NFFN) rOptional[Callable[[str], None]]rrerrerzOptional[bool]r r$)ror$r r)ror$r ztuple[str, str])rrr r$)rzOptional[float]rr)r zOptional[Dict[str, Any]])Ir) __future__rrLloggingrrrrrrpathlibrtypingrr r r r r rhermes_constantsrrrutilsr getLoggerr&rSrrr5rzrrrrr<rEr[rbrgrirqrvr}rrrrrrrrrrrrrrrrr.rEr|rirrrrrrr+rrr1s*#  22GGG,#   8 $&J&      ;  K ,  * &&(* 1 =(2$r NlD8UM|,$w< w< w<w<% w< % w