.cjT0dZddlmZddlZddlZddlZddlZddlZddlmZm Z m Z ddl m Z ddl mZmZmZmZmZmZmZddlmZddlmZdd lmZejeZdtdZGddeZdudZ dZ!dZ"dZ#dZ$dZ%dvdZ&dwdZ'dwdZ(dxd Z)dyd#Z*dzd$Z+dwd%Z,dzd&Z-d{d(Z.d|d*Z/d{d+Z0d{d,Z1dzd-Z2dzd.Z3d}d1Z4d~dd3Z5dd5Z6d~dd7Z7d8Z8d9Z9dvd:Z:dd>Z;ddFZ d~ddQZ?ddUZ@dd^ZAdd`ZBddaZC dddhZDddjZEddlZFddnZGdddoddsZHdS)uCurator — 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_writevaluerreturn Optional[str]cT|dSt|}|pdSN)strstrip)rtexts //home/ice/.hermes/hermes-agent/agent/curator.py_strip_aux_credentialr(s- }t u::    D <4cFeZdZUdZded<ded<ded<ded<ded <d S) _ReviewRuntimeBindingzCProvider/model for the curator review fork plus per-slot overrides.rprovidermodelrexplicit_api_keyexplicit_base_urlDict[str, Any]request_overridesN)__name__ __module__ __qualname____doc____annotations__rrr r /sNMMMMMJJJ####$$$$%%%%%%rr runtime_overridesslot_extra_bodyr%ct|pi}t|tr@|r>t|dpi}||||d<|S)z#ttj f$r%}t d|Yd}~nd}~wwxYwtS)Nutf-8encodingcNi|]!\}}|vs|d||"S)_) startswith).0kvbases r zload_state..ms5YYY$!Q!t))q||TWGXGX)A)))rz Failed to read curator state: %s)r=existsrFjsonloads read_textr2r1r4itemsOSErrorJSONDecodeErrorloggerdebug)pathdataerQs @r load_stater_es ==D ;;== <z$..'.::;; dD ! ! !##D KKYYYY$**,,YYY Z Z ZK  T) *<<< 7;;;;;;;;<   sA?B44C/ C**C/r]Nonect} t||dddS#t$r(}td|dYd}~dSd}~wwxYw)Nr8T)indent sort_keysz Failed to save curator state: %sexc_info)r=r ExceptionrZr[)r]r\r^s r save_statergts| ==DK$Q$?????? KKK 7T JJJJJJJJJKs% AAArDboolcdt}t||d<t|dSNrD)r_rhrg)rDstates r set_pausedrl|s. LLE6llE(Ourc^ttdSrj)rhr_r3r,rr is_pausedrns"    ** + ++rc ddlm}|}n4#t$r'}td|icYd}~Sd}~wwxYwt |t siS|dpi}t |t siS|S)zIRead curator.* config from ~/.hermes/config.yaml. Tolerates missing file.r load_configz%Failed to load config for curator: %sNcurator)hermes_cli.configrqrfrZr[r2r1r3)rqcfgr^curs r _load_configrvs111111kmm  | |kr8| |jkr+|||j|dxxdz cc<e| |kr7| |jkr,||\} } | r|dxxdz cc<| |kr8| |jkr-|||j|dxxdz cc<| |kr6| |jkr+|||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. rrN)days) marked_stalearchived reactivatedcheckedseededrnamepinned _persistedTrlast_activity_at created_atrrk use_countrrr)toolsrrrrrrrrragent_created_reportr3seed_record_if_missingrrr STATE_ACTIVEr| STATE_STALE set_stateSTATE_ARCHIVED archive_skill)r_u stale_cutoffarchive_cutoffcron_referencedcountsrowr last_activityanchorcurrent never_usedok_msgs rapply_automatic_transitionsr1s(''''' {l8<(((<(>(>????L9*@*B*BCCCCN-//OQqQZ[ \ \F&&((5'5'yQ6{ 778     ? " " ww|T**   % %d + + + 8    !    "377+=#>#>?? J*SWW\-B-B"C"CJs = ^^8<^88F'''2?33 a005A66!;  &<//".(( T2?333}%%%*%%%  ^ # #23D(D(D''--HB (z"""a'""" | # #2?(B(B LLr~ . . . > " " "a ' " " " " l " "w".'@'@ LLr / / / = ! ! !Q & ! ! ! 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 (note: long descriptions are truncated to 57 chars in the system prompt skill index — keep the trigger class in that window). 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 } |ddn2#t$r%}td|Yd}~nd}~wwxYw|S)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. logsrrTparentsexist_okz%Curator reports dir create failed: %sN)rmkdirrXrZr[)rootr^s r _reports_rootrAs   v % 1DA 4$ //// AAA >^ + + ff[!!'R! c4  %DD S ! ! % %z# % % %} %$%%  D!!!! {##c%+2&6&66L>*>*  ""&c3//c31G1GH 0 0 DXXf%%Ffc** & ~~\))02IU / /HHSMMa%%/$$c1X...C%  S%F!! k))";FC"H"H"&I&ABIf,=,=&A&A&A3GG##"-488Hc3J3J--#)--9=--"%crc(--! E    *   t R R S S S S MM64. ) ) ) )(F ; ;;sBB*)B* llm_finalDict[str, List[Dict[str, str]]]c ggd}|rt|ts|Sddl}|jd||j|jz}|s|S|d} ddl}||}n#t$r|cYSwxYwt|ts|Sggd}| dpg}| dpg} t|tr|D]} t| ts| d} | d } t| tr=| r)t| tr| s| d } |d| | t| tr| pd nd d t| tr| D]} t| ts| d }t|tr| sW| d } |d| t| tr| pd nd d|S)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)rrrr)rr)r2rrrDOTALL IGNORECASEgroupyaml safe_loadrfr1r3listrr)remptyrmatchbodyrr]outcons_rawprun_rawentryfrmrrrs r_parse_structured_summaryr%s "r 2 2E Jy#66 III BI" BM!  E  ;;q>>D ~~d##   dD ! ! >@b+Q+QCxx())/RHxx ##)rH(D!!  EeT** ))F##C99V$$DsC(( SYY[[ "4-- 26**,, YYx((F  ! ( (  4>vs4K4KS6vs4K4KS6`` 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_intoNT)rdeclared)r2r1r3rrTrUrfr)rr rrrrr s r#_extract_absorbed_into_declarationsr+4s&&(CBGG"d##   66&>>^ + + ff[!!'R! c4  DD S ! !  z#    $%%   88H   ) ) xx$$$ DJJLL   $ & & /** > &#&&  %+\\^^FFDJJLL JsB B#"B# heuristic model_blockrabsorbed_declarations#Optional[Dict[str, Dict[str, Any]]]c d|dgD}d|dgD}d|dgD}d|dgD}|pi} g} g} |D]e} || } || }|| }| | }||d d }|r\||vrX| |d | r| d pd nd d}|r |dr |d|d<| ||d kr4| | d|r|d pd nd d| ry| d |vrb| | d d|rdnd z| d pd d}|r |dr |d|d<| || rq| d |vrZ|r=| | |d dd |dd | d dn| | dd d|r7| | |d dd |dd d.|r|d d nd }| | |rdnd|dg| | dS)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. c i|] }|d| Srr,rNr^s rrRz-_reconcile_classification..sIII!6AIIIrrch|] }|d Sr2r,r3s r z,_reconcile_classification..sBBB1V9BBBrrc i|] }|d| S)rr,r3s rrRz-_reconcile_classification..sNNN1!F)QNNNrrc i|] }|d| Sr2r,r3s rrRz-_reconcile_classification..sJJJQAfIqJJJrrNrrz(absorbed_into (model-declared at delete)r)rrsourcerrz'absorbed_into="" (model-declared prune))rr8rr"z+auditz.tool-call audit (model named missing umbrella))rrr8rrmodel_claimed_intoz>fallback (model named missing umbrella, no tool-call evidence)z5tool-call audit (model omitted from structured block))rrr8rrzno-evidence fallbackr)r3r)rr,r-rr. heur_cons heur_pruned model_cons model_prunedr*rrrmcmphcdec into_claimr#rs r_reconcile_classificationrCjs<JIy}}^R'H'HIIIIBBimmHb&A&ABBBKNN 8H"(M(MNNNJJJ+//*b*I*IJJJL$*H)+L#%FU U  ^^D ! !   d # # ]]4 ll4   ?,,J jL88 &H:<Drvvh//52" )) 7"&&,,7(*:E*%##E***R  I:<Drvvh//52"   "&&..L006 !%;XX<&&**0b %%E  3bffZ(( 3$&zNj!    & & &   "&&.. 44 ## vJN "z2 6 6*,V* %%  ^       6 QFF:r22 !!    *,3"%%% !#?gg)?      )F ; ;;r before_names after_report model_finalcd|D}t|}t||z }t||z }|sdSt||||}t |} t|t|z} t |} t ||| | | } | d} | d}d}g}t| t|z}|d|d d }| D]V}||krnM| d d }| d d }|d|d||dz }W|D]b}||krnYt|tr| d d nt|}|d|d|dz }c||kr|d||z d|d| r;td| D}|r |d }|d|d |S)uFormat the user-visible rename map for a curator run. Renders the "where did my skills go?" lines that get appended to the `final_summary` string fed to gateway/CLI receivers. Empty string when nothing was archived this run — most ticks are no-op and shouldn't add extra log noise. Format:: archived 4 skill(s): • pdf-extraction → document-tools • docx-extraction → document-tools • flaky-thing — pruned (stale) • old-utility → spreadsheet-ops full report: hermes curator status keep an umbrella stable: hermes curator pin document-tools Cap is 10 entries so a 50-skill consolidation doesn't blow up agent.log; the full list is always in REPORT.md. The pin hint only appears when at least one consolidation produced an umbrella worth pinning (pruned-only runs skip it). cdi|]-}t|t|d|.Sr2r2r1r3rNrs rrRz)_build_rename_summary.. 3SSS!z!T?R?RSQUU6]]ASSSrrrrrrrr,r-rr.rr z archived z skill(s):rrrru •  → ru — pruned (stale)u … and z morez"full report: hermes curator statuscbh|],}|d|d-S)r)r3r3s rr5z(_build_rename_summary..>s1QQQa155==QAEE&MMQQQrz,keep an umbrella stable: hermes curator pin  )rkeyssortedrr%r+rClenrr3r2r1rjoin)rDrErrF after_by_namerrrr,r-rr.classificationrrSHOWlinestotalshownr#rr umbrellasexamples r_build_rename_summaryr_s:TS|SSSMm((**++K\K/00G ;- . .E r( I ,K88K{##c%jj0L? KK.!3 N".1L H %F DE   F +E LL.U.../// E D== Eyy%%yy%% /d////000   D== E)3E4)@)@Puyy%%%c%jj 7d777888   t|| 5%$,555666 LL5666 QQ<QQQRR  lG LLHwHH    99U  r started_atrelapsed_seconds auto_counts auto_summary before_reportllm_metaOptional[Path]c t} |ddn3#t$r&} td| Yd} ~ dSd} ~ wwxYw|d} || z } d} | r#| dz } || d| z } | # | ddn3#t$r&} td | Yd} ~ dSd} ~ wwxYwd |D} t| }t||z }t||z }d |D}g}t||zD]y}| |pi d }| |pi d }|r!|r||kr| |||d zi}| dgpgD]4}| dd}| |ddz||<5t|||| dgpg}t| ddpd}t|t|pgz}t| dgpg}t|||||}|d}|d}gddd} d|D} d|D}!| s|!rddlm}"|"| |!}nH#t$r;} td| dgddt%| d}Yd} ~ nd} ~ wwxYwid |d!t)|d"d#| d#dd$| d$dd%|d&t+|t+|t+|t+|z t+|t+|t+|t+|t+|t-| d'dt/|d( d)|d*|d|d|d+d,|Dd-|d.|d/|d0| ddd1| d2dd3| d4d| dgi}# | d5z t5j|#d"d6d7zd89n2#t$r%} td:| Yd} ~ nd} ~ wwxYw t9|#}$| d;z |$d89n2#t$r%} td<| Yd} ~ nd} ~ wwxYw t-| d'ddkr2| d=z t5j|d"d6d7zd89n2#t$r%} td>| Yd} ~ nd} ~ wwxYw| S)?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: %scdi|]-}t|t|d|.Sr2rIrJs rrRz%_write_run_report..lrLrcdi|]-}t|t|d|.Sr2rIrJs rrRz%_write_run_report..ps3UUU1AtATATUaeeFmmQUUUrrk)rrtorrunknownrrMfinalrrNrr)rewrites jobs_updated jobs_scannedci|]P}t|t|d,|dA|d|dQS)rrrIr3s rrRz%_write_run_report..sj   !T"" ()uuV}} :;v fIqy   rcrg|]4}t|t|d,|d5Sr2rIr3s r z%_write_run_report..sN   !T"" '(uuV}} fI   r)rewrite_skill_refsrz%Curator cron skill rewrite failed: %srd)rmrnroerrorr`duration_secondsr8r"r!auto_transitionsrrn) beforeafterdeltaarchived_this_runadded_this_runconsolidated_this_runpruned_this_runstate_transitionscron_jobs_rewrittentool_calls_totaltool_call_countsr pruned_namescg|] }|d Sr2r,)rNps rrrz%_write_run_report..s333q6333rrr~ cron_rewritesr llm_summarysummary llm_errorrtzrun.json)rb ensure_asciirRrHrIz!Curator run.json write failed: %sz REPORT.mdz"Curator REPORT.md write failed: %szcron_rewrites.jsonz+Curator cron_rewrites.json write failed: %s)rrrfrZr[strftimerSrrSrTr3rrr%r+rCrrsrrroundrUr|sumvalues write_textrTdumps_render_report_markdown)%r`rarbrcrdrDrErerr^stamprun_dirsuffixrWrrrbefore_by_name transitionsrs_befores_after tc_countsrr,r-rr.rXrrrconsolidated_mapr_rewrite_cron_refspayloadmds% r_write_run_reportrGs ??D 4$ ////  ;Q???ttttt    0 0EUlG F ..  -! E,,F,,, ..  - dU 3333  8!<<<ttttt TS|SSSMm((**++K\K/00G ;- . .EUU UUUN)+K{\122PP"&&t,,277@@ $$T**0b55g>>  P PH$7$7   hgNN O O O!#Ill<,,255vvfi((#--a0014 $ )<< b117R I ,HLL",E,E,KLLK{##c%+2&6&66L @ \2&&,"/!3 N".1L H %F24QXY$Z$ZM   !      %     |  J J J J J J..-#M      $W - - ; **2*@@@@ >>> 91========> G }  33 4 4q 8 8 + + 7 7 =GGG$N  8    GGG BAFFFFFFFFG Ns( AAA/C C7C22C73/L## M(-1M##M( 2T<< U+U&&U+/)V W#WW AX&& Y0YYrcg}|dd}|ddpd}tt|d\}}|r|d|dn|d}|d|d |d pd }|d pd }|d pi} |d|d|d|d| ddd| ddd| dddd |d} | r|d| d|dpi} |d|d| dd|d | d!d|d"| d#d|d$| d%d|d|d&pi} |d'|d(| d)dd*d+d,t | Dpd-d.|d/| d0dd1|d2| d3dd1|d4| d5dd1|d6| d7dd1|d|d8pg} | r|d9t| d|d:d;}| d<|D]}|d=d>}|d?d>}|d@pd}|dAd}dB|dC|dD}|r|dE|z }|r| dFr |dG|dHz }|||dIr|dJ|dIdKt| |kr)|dLt| |z dM|d|dNpg}|r.|dOt|d|dPd;}|d<|D]}t|tre|d=d>}|d@pd}dB|dD}|r|dE|z }||||dB|dDt||kr)|dLt||z dM|d|dQpg}|rn|dRt|d|dS|D]}|dB|dD|d|d7pg}|r|dTt|d|D]Y}|dB|d=dU|dVd|dWZ|d|dXpi}|dYpg}|r|dZt|d|d[d\}|d<|D]&}|d]p|d^pd>}|dpg}|dpg}|d_pi}|d`pg} |dB|dad+|dbd+|pdcdD|D]!\}!}"|dd|!db|"de"| D]}|dd|df(t||kr)|dLt||z dg|d|dhpd}#|#r@|di||#|dnZ| sX|djpd}$|$r?|dk||$|d|dl|dm|dn|do|dd |S)pz!Render the human-readable report.r`rrur<zm su# Curator run — rRr"z(not resolved)r!rzModel: `z` via `u` · Duration: u · Agent-created skills: rwrPrxz (ryz+dz) ru> ⚠ LLM pass error: `z` rvz### Auto-transitions (pure, no LLM) z - checked: rz- marked stale: rz0- archived (no LLM, pure time-based staleness): rz- reactivated: rrz## LLM consolidation pass z- tool calls: **rz ** (by name: , c3*K|]\}}|d|VdS)=Nr,)rNrOrPs r z*_render_report_markdown..*s0'Y'Ytq!1 q 'Y'Y'Y'Y'Y'Yrnone)z!- consolidated into umbrellas: **r|z**z%- pruned (archived for staleness): **r}z- new skills this run: **r{u7- state transitions (active ↔ stale ↔ archived): **r~rz'### 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._ 2Nrrrrr8z- `u` → merged into ``u — ztool-call auditz _(detected via z)_r9u# ⚠ 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`: rrjrrmz)### 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 rz## 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.) r3divmodr|rrVrTrWrUrrMr2r1)%rrZstarteddurationminssecs dur_labelr"provrrtautorrrYr#rrrr8linerrntranstcron_rwcron_rewrites_listrrwrxrroldnewrlllm_sums% rrrs4 EeeL"%%Guu'++0qHH r**JD$&*:4""4""""4 I LL1g111222 EE'NN ..E 55   0 0D UU8__ "F LL +5 + + + +  + +!'Ha!8!8 + +?Ezz'ST?U?U + + JJw " "* + + + EE+  E ; 9u999::: 55# $ $ *D LL7888 LL7txx 15577888 LLADHH^Q$?$?AABBB LL]DHHZYZD[D[]]^^^ LL?488M1#=#=??@@@ LL())/RI LL./// LLgFJJ/A1$E$Egg"ii'Y'YviooFWFW?X?X'Y'Y'YYYc]cggghhh LL_VZZ@WYZ5[5[___``` LL]DUWX9Y9Y]]]^^^ LLPVZZ8H!-L-LPPPQQQ LL=jj!4a88===>>> LL 55((.BL Us> 76F6666 LL   yy-..  E%@T:UEEE |  t # # LLVc,&7&7$&>VVV W W W RUU8__ "F  Os6{{OOOPPP  B   ETE] - -E%&& -yy--))H--3::<<$T}}}-,F,,,D T"""" ^5^^^,,,, v;;   LLPc&kkD&8PPP Q Q Q R EE'NN bE  @U@@@AAA pqqq % %A LLq $ $ $ $ R EE% & & ,"E  >s5zz>>>??? T TA LLRquuV}}RRvRRQUU4[[RR S S S S R eeO$$*G Z006B ]EWAXAX]]]^^^  R   '. A AEyy,,J (0C0CJsHYYx((.BFIIg&&,"EYYx((.BFii **0bG LL]h]]DIIf$5$5]]dii>N>N>ZRZ]]]   #LLNN J JS HsHH3HHHIIII A A ?t???@@@@ A ! " "T ) ) LL-S!344t;---     RUU;   %2 , , . .E  -... U R %% &&,"   LL+ , , , LL ! ! ! LL    LL!!! LLOPPP LLefff LL[\\\ LL 99U  rc0tj}|sdSt}dt|dg}|D]}|d|dd|dd|d rd nd d |d|vrd nd d |ddd|ddd|ddd|ddd|dpdd|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=rkz pinned=ryesnoz cron=z activity=activity_countrz use=rz view= view_countz patches= patch_countz last_activity=rneverrR)rrrrUrr3rV)rowsrrZrKs r_render_candidate_listrs  + - -D 433-//O 5c$ii 5 5 5 6E      D6 D DwZ D D uuX8eeD D DvY/99EEt D D.22  D D 55a((  D D EE,**  D Duu]A.. D DUU#566A' D D  99U  r on_summaryOptional[Callable[[str], None]] synchronousdry_runrOptional[bool]c ttjtjr@ t j}t|dddd n#t$r ddddd YnwxYw ddl m }| d}|(r& d|j dn#t$rYnwxYwn4#t$r'}td |d Yd}~nd}~wwxYwt  g} d r| d d dr| dd dr| dd|rd|nd t%} s@| d<t)| dddz| d<rdnd | d<t-|   fd} |r | n+t/j| d d} |  dS)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)rzcurator: snapshot created (rz#Curator pre-run snapshot failed: %sTrd)rrz marked stalerz archivedrz reactivatedrz no changesr?rErzdry-run auto: zauto: rAc  tj}n#t$rg}YnwxYwd|D}s d}ddddgdd}tjt jz }t}||d<||d< tj}n#t$rg}YnwxYw t| ||||}|t||d <n4#t$r'}t d |d Yd}~nd}~wwxYwt|r d |n#t$rYnwxYwdSi} t} d| vr d}ddddgdd}ned} trd} rt dt"| d| } nt"| d| } t%| } d|dd}nX#t$rK}t d|d  d|d}dd|dddgt|d}Yd}~nd}~wwxYw t)|tj|dgpg|ddpd} | r|d| }n4#t$r'}t d|d Yd}~nd}~wwxYwtjt jz }t}||d<||d< tj}n#t$rg}YnwxYw t| ||||}|t||d <n4#t$r'}t d |d Yd}~nd}~wwxYwt|r" d |dS#t$rYdSwxYwdS)Ncbh|],}t|t|d-Sr2rIrJs rr5z8run_curator_review.._llm_pass..8s1TTT! 1d@S@STf TTTrz"; llm: skipped (consolidation off)rzskipped (consolidation off)rlrr"r!rrtr@rA)r`rarbrcrdrDrErerCzCurator report write failed: %sTrdz 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 (rrl)rDrErrFrRz'Curator rename summary build failed: %s)rrrfrrrr total_secondsr_rrrZr[rgrrCURATOR_DRY_RUN_BANNERCURATOR_REVIEW_PROMPT_run_llm_reviewr3r_)rdrD final_summaryreelapsedstate2rE report_pathr^candidate_list builtins_noteprompt rename_linesrcrrrrprefixstarts r _llm_passz%run_curator_review.._llm_pass1s '<>>MM   MMM TT}TTT ) K<KKK 8  H |HL11E9HHJJG\\F29F. /)6F% & "*?AA  " " "!  " R/$$+ &!-"/!-!-%    *14[1A1AF-. R R R >D QQQQQQQQ R v    J:=::;;;; D F#%3 355N(N::#) W< W W W 8 ""$! !# %'' ;"[1,,0,2?,,),,F !6Z}ZZ.ZZF*622Z|ZZHLLK4X4XZZ    LL6DL I I I%G|GG1GGGM)Q>>> Q HHHHHH  V0)(=??#<< b99?R$LL"55; L  C#0 B BL B B  V V V LLBAPTL U U U U U U U U V< --5DDFF.5*+%2!"  &;==LL   LLL  N+ '")+))!   K&-0-=-=)* N N N LL:AL M M M M M M M M N 6    6}6677777      s &&B(( B76B7;+C'' D1DD-D<< E E BG H/$AH**H/3AJ J>J99J> L!! L0/L04+M N*N  N&N66 OOzcurator-review)r daemonr)r`rvsummary_so_far)rrrrrrrrUrfagentrsnapshot_skillsrrZr[rrrVr_rr|r3rg threadingThreadr)rrrrreportrsnapr^auto_summary_partsrkrrrcrrrs` `` @@@@rrun_curator_reviewrsSD%'' L & &E8 X 577Fv;; ! FF  X X X!"A1UVWWFFF X R , , , , , ,!119J1KKDJJITYIIIJJJJ D R R R LL>DL Q Q Q Q Q Q Q Q R,777 nL!!VN%;"J"J"JKKK jD!!VJ%7"B"B"BCCC mJ!!VM%:"H"H"HIII4FX499/000LL LLE @$00m ;!:!:;;a?k!( 6  hF#) 9< 9 9E u```````````D  IdAQ R R R  oo''"&  sM'A!!A54A59 CB/.C/ B<9C;B<<C C1 C,,C1rtc t|dtr|dini}|dpd}|dp|dpd}t|dtr|dini}t|dtr|dini}|dpdpd}|dpdpd}|r||dkrv|rtt ||t |d t |d t i|d St|dtr|dini}t|dtr|dini} | dpd} | dpd} | r| rtd t t| t| t | d t | d t i| d 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"r!rdefaultr auxiliaryrrNapi_keybase_urlr0u|curator: using deprecated curator.auxiliary.{provider,model} config — please migrate to auxiliary.curator.{provider,model}) r2r3r1rr rr6rZinfor) rt_main_main_provider _main_model_aux _cur_task_task_provider _task_model_cur_legacy_legacy_provider _legacy_models r_resolve_review_runtimers%/swww/?/?$F$F NCGGGR BEYYz**4fN))I&&B%))G*<*<BK(2#''+2F2F'M'M U377; # # #SUD+5dhhy6I6I4+P+PXB'''VXImmJ//52<<>>F$N==))/R6688@DK .F22{2$   !)-- ":": ; ; !)-- ";"; < < $R|)D)D E E    &0 0B0BD%I%I Q3779b ! ! !rD+5dhh{6K6KT+R+RZdhh{B'''XZG{{:..6$KK((0DM  M    N   %  ! !    !'++i"8"8 9 9 !'++j"9"9 : : $R\)B)B C C     !dD" M MMrtuple[str, str]c<t|}|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 )rr!r")rtbs r_resolve_review_modelrs  $$A :qw rrc t ddl}ddddgdd} ddlm}n,#t$r}d||d<|d|d<|cYd}~Sd}~wwxYwd}d}d}d}d} i} d} d} d} d} dd lm}dd lm}|}t|}|j |j }}||||j |j }| d }| d }| d}| dp|}| d} t| d|j d} | d} | d} t!| dpg} t#| dt$r4|dr|d}n4#t$r'}t(d|dYd}~nd}~wwxYw||d<|pd|d<d} i}t#| t,r| |d<t#| t$r| r | |d<| pg|d<|d3|||||| | d|dddddd }d|_d|_d!|_t5t6jd"d#$5}||5||5||%}dddn #1swxYwYdddn #1swxYwYdddn #1swxYwYd}t#|t@r6t%| d&pd}||d'<tC|d(kr |dd(d)zn|pd*|d<g}tE|d+gpgD]}t#|t@s| d,pg}|D]}t#|t@s| d-pi}| d.pd}| d/pd} t#| t$r tC| d0kr | dd0d)z} |#|| d1||d,<n*#t$r}d2||d<|d|d<Yd}~nd}~wwxYw|& |$n>#t$rYn2wxYwn-#|& |$w#t$rYwwxYwwxYw|S)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: rtrrp)resolve_runtime_provider) requested target_modelr#r$rrapi_moder!credential_poolr&r0max_output_tokenscommandrr"z&Curator provider resolution failed: %sTrd max_tokens acp_commandacp_args)r"r!rrrrr&i'rr)max_iterations quiet_modeplatformskip_context_files skip_memorybackground_reviewwrHrI) user_messagefinal_responserlu…r_session_messagesrfunctionrri)rrzerror: r,)% contextlib run_agentrrfrsrqhermes_cli.runtime_providerrrr!r"r#r$r3r6r&rr2rrrZr[r|_memory_nudge_interval_skill_nudge_interval_memory_write_originopenosdevnullredirect_stdoutredirect_stderrrun_conversationr1rUgetattrrclose)!rr result_metarr^_api_key _base_url _api_mode_resolved_provider_credential_pool_request_overrides _max_tokens _acp_command _acp_args _model_namerqr_cfg_binding _provider_rp review_agent _agent_kwargs_devnull conv_resultrl_callsmsgtcsrfnrargs_raws! rrr#s ##K%%%%%%% <<< G!,W!5 I HII)+KLIKQ111111HHHHHH{}}*400!)!2HN; &&$%6&8     779%%GGJ'' GGJ''  WWZ00=I77#4555 GG' ( (  & * *< 8 8  gg122 wwy)) .B// cggg&& , , /W1C1C1E1E /g,,,..K QQQ =q4 PPPPPPPPQ'K06BK LR(* k3 ' ' 6*5M, ' lC ( ( 8\ 8+7M- ((1RM* %w ',0    #%    */0 +-. *-@ )"*cG 4 4 4 M  ' ' 1 1 M M  ' ' 1 1 M M'77V7LLK M M M M M M M M M M M M M M M M M M M M M M M M M M M M M M M M M M M M M M M M M M M M M  k4 ( ( I (899?R@@FFHHE$ G:=e**s:J:J%+"5"5QVQeZe I (*<)H  H%7BR8?L<L%+L L%L L%L L% L<%L) )L<,L) -L<0 R8<MR8ME3R87T 8 SST ST %S:: TT T5T$#T5$ T1.T50T11T5)idle_for_secondsrr@Optional[float]Optional[Dict[str, Any]]c tsdS|tdz}||krdSt|S#t$r(}td|dYd}~dSd}~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: %sTrd)rrrrfrZr[)r@r min_idle_sr^s rmaybe_run_curatorrEs  4  '+--6J*,,t!Z8888  3Q FFFttttts=== A/A**A/)rrrr)r-rr.rrr%)rr)rr%)r]r%rr`)rDrhrr`)rrh)rr|)rr)rrrrr)rrrrh)rr)rrrr)rrr\rrrh) rrrrrrrrrr)rrrr)rrrr&) rrr,rr-rrrr.r/rr) rDrrErrrrFrrr)r`rrarrbrrcrrdrrDrrErrer%rrf)rr%rr)rr)NFFN) rrrrhrrhrrrr%)rtr%rr )rtr%rr)rrrr%)r@rArrrrB)Ir* __future__rrTloggingr!rrrrrpathlibrtypingrr r r r r rhermes_constantsrrrutilsr getLoggerr'rZrr r6rrrrrr=rFr_rgrlrnrvr{rrrrrrrrrrrrrrrr%r+rCr_rrrrrrrrEr,rrrMs*#"""""  2222222222GGGGGGGGGGGGGGGGGG,,,,,,######  8 $ $&&&&&J&&&      ;;;;        KKKK ,,,,     **** &&&&&&&&((((**** 1 1 1 1 = = = =(2$2$2$2$2$r    NNNNNlD8WM@,$w<w<w<w