i UdZddlmZddlZddlZddlZddlZddlZddlm Z ddl m Z m Z m Z mZmZ ddlmZn#e$r ddlZdd ZYnwxYw dd lmZn#e$rGd d ZYnwxYweZd ZejZdaded<dadddddddZded<ej dej!Z"ej dej!Z#ej dej!Z$ej dej!Z%ej dZ&gdZ'ddZ(dd"Z)gd#d$d%d&d'd(d)e(gd*d+d,d-d.d&d/d0d1e(gd2d+d3d4d5d&d'd6d7e(gd8d+d9d:d;d&dd?e)d@d e)dAdBgdCdDdEdFd&d/dGdHe(gdId+dJdKdLd&d/dMdNe(gdOd+dPdQdRd&d/dSdTe(gd2d+dUdVdWdXd/dYdZe(gd[d+d\d]d^dXd/d_d`e(gdad+dbdcdddXd/dedfe(gd2d+dgdhdidXd/djdkdle(gdmdn dodpdqdXd/drdkdse(gdtdn dudvdwdXdd?d!d/d_d#e(gd d+d@dAdBd!d/ddCe(gdDd+dEdFdGd!d/ddHe(gdDd+dIdJdKd!d/ddLe(gdMd+dNdOdPdd/ddQe(gdRd+dSdTdUdd/ddVe(gdWd+dXdYdZdd/dGd[e(gdd+d\d]d^dd/dMd_e(gd`d+dadbdcdd/ddde(gded+dfdgdhdid/djdke(gdld+dmdndodid/dpdqe(gdtd+drdsdtdid/dudve(gdtd+dwdxdydid/dzdkd{e(gdТdn Z*ded|<dd}Z+dd~Z,ddZ-ddZ.ddZ/ddZ0ddZ1ddZ2ddZ3ddZ4ddZ5ddZ6dddZ7dddZ8ddZ9ddZ:d dZ;d!dZ<d"dZ=d#dZ>d$dZ?d$dZ@d$dZAid)dd7dd>dd@ddAddddddHddNddTddZdd`ddfddlddsddydd{didddddddddddddddd“dŐdÓdʐdēdϐdœdՐdƓdڐdǓdߐdȓddɓddʓdd˓id#d̓d(d͓d-dΓd{dϓddГddѓddғd1dӓddԓd dՓdd֓ddדddؓd2dٓd;dړdCdۓdHdܓdݐdސdߐddddddddd ZBd%dZCd&dZDd'dZE d(d)dZFd*dZGd$dZHd+dZIddd,dZJd-d.dZKdaLded<ejZMd/dZNd0d1dZOd2dZPd3d4dZQeRddZSeRddZTeRd d ZUeRd d5d ZVeWd dZXeWddZYdS(6zqHermes Achievements dashboard plugin backend. Mounted at /api/plugins/hermes-achievements/ by Hermes dashboard. ) annotationsN)Path)AnyDictListOptionalSetget_hermes_homereturnrctjdpd}|rt |nt jdz S)N HERMES_HOMEz.hermes)_osenvirongetstriprhome)vals O/usr/local/lib/hermes-agent/plugins/hermes-achievements/dashboard/plugin_api.pyr r sF{}--3::<<zAPIRouter.get..brrself_args_kwargss rrz APIRouter.get  = rcdS)Nc|Srrrs rr z APIRouter.post..r!rrr"s rpostzAPIRouter.postr&rN)__name__ __module__ __qualname__rr)rrrrrs2 ! ! ! ! ! ! ! !rrxOptional[Dict[str, Any]]_SNAPSHOT_CACHEidle)state started_at finished_at last_errorlast_duration_ms run_countDict[str, Any] _SCAN_STATUSzv\b(error|failed|failure|traceback|exception|permission denied|not found|eaddrinuse|already in use|timed out|blocked)\bz^\b(port\s+)?(3000|5173|8000|8080|9119)\b.*\b(in use|already|taken|eaddrinuse)\b|\beaddrinuse\bz-\b(npm|pnpm|yarn|pip|uv)\b.*\b(install|add)\bzO\b(success|passed|built|compiled|done|exit_code[\"']?\s*[:=]\s*0|verified|ok)\bz[(?:/home/|~/?|\./|/mnt/)[\w./-]+\.(?:py|js|ts|tsx|jsx|css|html|md|json|yaml|yml|svg|sql|sh))CopperSilverGoldDiamondOlympianvalues List[int]List[Dict[str, Any]]c@dtt|DS)Ncg|] \}}||d S))name thresholdr).0rCrDs r ztiers..9s$ b b btYT 2 2 b b br)zip TIER_NAMES)r>s rtiersrI8s! b b#jZ`JaJa b b bbrmetricstrgteintc ||dS)NrJrLrrOs rreqrP<sS ) ))r let_him_cookz Let Him Cookz>Let Hermes run a serious autonomous tool chain in one session.zAgent Autonomy best_sessionflamemax_tool_calls_in_session) @)idrC descriptioncategorykindiconthreshold_metricrIautonomous_avalanchezAutonomous AvalanchezEAccumulate a lifetime avalanche of Hermes tool calls across sessions.lifetime avalanchetotal_tool_calls)rXrY NPtoolchain_maxxerzToolchain Maxxerz:Use a wide spread of distinct Hermes tools in one session.nodesmax_distinct_tools_in_session)-Fd full_sendz Full SendzBTerminal, files, and web/browser all get involved in one real run.multi_conditionrocketmax_terminal_calls_in_sessionmax_file_tool_calls_in_session max_web_browser_calls_in_session<)rZrCr[r\r]r^ requirementssubagent_commanderzSubagent Commanderz Coordinate delegated agent work.branchtotal_delegate_calls)(rnrdbackground_process_enjoyerzBackground Process EnjoyerzDStart or control enough long-running processes to deserve the title.daemontotal_process_calls), p:cron_necromancerzCron Necromancerz.Raise scheduled autonomous jobs from the dead.clocktotal_cron_callsred_text_connoisseurzRed Text Connoisseurz9Encounter enough errors to develop a palate for red text.zDebugging Chaoswarning total_errors)'ai$stack_trace_sommelierzStack Trace Sommelierz/Taste tracebacks by the flight, not by the sip.winetraceback_events)rrdrXrYreactually_read_the_logszActually Read The Logsz,Inspect logs repeatedly instead of guessing.scrolllog_read_eventsport_3000_takenzPort 3000 Is TakenzGDiscover dev-server port conflict patterns enough times to become numb.plugTport_conflict_events)r|rnrrd) rZrCr[r\r]r^secretr_rIpermission_denied_any_percentzPermission Denied Any%zSpeedrun into permission walls.lockpermission_denied_events)KrUXrdependency_hell_touristzDependency Hell Touristz3Package installs fail, then somehow life continues. package_skullinstall_error_eventsrinstall_success_events the_fix_was_restartingzThe Fix Was Restarting Itz;Restart after enough error clusters to call it a technique.restartrestart_after_error_events2rforgot_the_env_varzForgot The Env VarzIAuth or configuration failed because an environment variable was missing.keyenv_var_error_events)r}ri@iiyaml_colon_incidentzYAML Colon Incidentz Configuration syntax bites back.colonyaml_error_eventsdocker_name_collisionzDocker Name Collisionz3A container name already exists. Of course it does. containerdocker_conflict_events)rrUrrrsupposed_to_be_quickzThis Was Supposed To Be Quickz(A tiny ask becomes an entire expedition.z Vibe Coding melting_clockmax_messages_in_session)rrrWi rone_more_small_changezOne More Small ChangezLMake enough file edits in one session to invalidate the phrase small change.pencil)rdrXrYvibe_architectzVibe Architectz2Touch a broad surface area in one project session. blueprintmax_files_touched_in_session)rirrr pixel_goblinz Pixel Goblinz2Do sustained frontend, CSS, SVG, or visual tuning.pixelfrontend_activity_events)rerfiii5 ship_first_ask_laterzShip First, Ask Laterz(Git activity after a serious tool chain.ship git_eventsrV css_exorcistz CSS Exorcistz2Cast repeated styling demons out of the interface. spark_cursorcss_activity_events)ri0ui8i@ i one_character_fixzOne Character Fixz7A tiny edit after a pile of errors. Painful. Beautiful.needletiny_patch_after_errors_eventsr{)rZrCr[r\r]r^rrw skillsmith Skillsmithz5Work with Hermes skills enough to leave fingerprints.z Hermes Native hammer_scroll skill_eventsskill_issue_skill_createdzSkill Issue? Skill Created.zACreate or patch durable procedures instead of repeating yourself.anvilskill_manage_events memory_keeperz Memory Keeperz3Persist durable knowledge with memory or Mnemosyne.crystal memory_events)rnrrdrXrY memory_palacez Memory Palacez%Build a serious durable-memory trail.palacememory_write_eventscontext_dragonzContext DragonzFBrush against compression, huge context, or token pressure repeatedly.dragoncontext_eventsgateway_dwellerzGateway Dwellerz0Live through gateway-connected Hermes workflows.antennagateway_events plugin_goblinz Plugin Goblinz9Use or develop plugins enough that the dashboard notices.puzzle plugin_eventsrollback_wizardzRollback Wizardz*Invoke rollback/checkpoint recovery magic.rewindrollback_events)rVrrrrrabbit_hole_certifiedzRabbit Hole CertifiedzESearch or extract enough web content to qualify as a research spiral.z Research/Webspiraltotal_web_calls)rrWrXrYrecitation_goblinzCitation Goblinz4Extract enough web pages to become a tiny librarian.quotetotal_web_extract_callsdocs_archaeologistzDocs Archaeologistz0Dig through documentation sources over and over.compassdocs_activity_eventsbrowser_possessionzBrowser Possessionz0Possess a browser through automation repeatedly.browser browser_callsterminal_goblinzTerminal Goblinz!Spend serious time in shell-land.z Tool Masteryterminaltotal_terminal_calls)rrrrf patch_wizardz Patch Wizardz.Bend files to your will with targeted patches.wandtotal_patch_calls)rrrrfile_archaeologistzFile Archaeologistz3Dig through the filesystem with reads and searches.foldertotal_file_reads_searchesimage_whispererzImage WhispererzSwitch or inspect providers/models enough to count as a habit.z Model Loreswap model_eventsopenrouter_enjoyerzOpenRouter Enjoyerz/Route model work through OpenRouter repeatedly.routeropenrouter_eventscodex_conjurerzCodex Conjurerz;Summon Codex-flavored assistance often enough for a ritual.codex codex_eventsmulti_model_magezMulti-Model Magez@Use a real spread of distinct model names across Hermes history.prismdistinct_model_count)rr|Pfive_model_flightzFive-Model FlightzQTry at least five distinct LLMs instead of marrying the first model that answers.)r{rr r|r provider_polyglotzProvider Polyglotz9Use models from multiple providers across Hermes history.distinct_provider_count)r{ model_sommelierzModel SommelierzATaste enough model/provider conversations to develop preferences.claude_confidantzClaude Confidantz=Bring Claude-flavored reasoning into the workflow repeatedly. claude_events)rrrVrrgemini_cartographerzGemini Cartographerz8Map enough Gemini-related workflows to know the terrain. gemini_eventsopen_weights_pilgrimzOpen Weights PilgrimzLActually chat with local/open-weight models through Hermes session metadata.local_model_chat_sessions)rrrrntoolset_cartographerzToolset CartographerzJNavigate Hermes toolsets deliberately instead of treating tools as a blur.toolset_events)r rvrUrrconfig_surgeonzConfig Surgeonz]Operate on real config files, manifests, env files, and dashboard settings without flinching. config_events)rnrrdrXrrebase_acrobatzRebase AcrobatzFHandle real git history surgery: rebase, conflict, merge, fetch, push.git_history_eventstest_suite_tamerzTest Suite TamerzLRun enough verification commands that green text becomes part of the ritual. test_events)rnrri` rscreenshot_hunterzScreenshot HunterzLCapture, inspect, and polish visual proof instead of just claiming it works.screenshot_events)rrrVrr}marathon_operatorzMarathon Operatorz/Accumulate a serious number of Hermes sessions. Lifestylemarathon session_count)rrUrVrr}weekend_warriorzWeekend Warriorz;Run Hermes on weekends enough times to make it a lifestyle.calendarweekend_sessionsnight_shift_operatorzNight Shift Operatorz-Run sessions during gremlin hours repeatedly.moonnight_sessionscache_hit_appreciatorzCache Hit Appreciatorz-Notice or benefit from prompt/cache behavior.cache cache_events ACHIEVEMENTSc0tdz dz dz S)Npluginshermes-achievementsz state.jsonr rrr state_pathr9s   y (+@ @< OOrc0tdz dz dz S)Nr7r8zscan_snapshot.jsonr rrr snapshot_pathr;s   y (+@ @CW WWrc0tdz dz dz S)Nr7r8zscan_checkpoint.jsonr rrrcheckpoint_pathr=s   y (+@ @CY YYrct}|sdiiS tj|S#t $rdiicYSwxYw)Nunlocks)r9existsjsonloads read_text Exception)paths r load_staterFso <z_json_safe..s$;;;TQ:a==;;;rc,g|]}t|SrrVrErYs rrFz_json_safe..s---! 1 ---rc34K|]}t|VdSrrVr\s r z_json_safe..s(33jmm333333r) isinstancedictitemslisttuplesetsorted)rSs rrWrWs%<;;U[[]];;;;%$''.--u----%433U333333 Lrct}|sdS tj|}t |t r|Sn#t$rYdSwxYwdSr)r;r@rArBrCr_r`rDrEdatas r load_snapshotris ??D ;;==tz$..**++ dD ! ! K  tt 4s.s 333tzz||333rc3TK|]!tfdDdV"dS)c3 K|]}|vV dSrr)rErrCs rr^z(_count_tool...s'+Q+QvFdN+Q+Q+Q+Q+Q+QrrN)any)rErCrs @rr^z_count_tool..sFRRT+Q+Q+Q+Q+Q+Q+Q(Q(QRqRRRRRRr)sum)rrlowereds ` r _count_toolrs933 333G RRRRWRRR R RRr model_namec<|pd}|r|dkrdSd|vr|dddSdD]}||vr |dkrdn|cS|d ddd ddS) Nrnone/rr)openai anthropicgooglegeminimistralrvqwendeepseekxainousollamagroq openrouterrrr:-)rrsplit)rrCproviders rmodel_providerr"s  " # # % % + + - -D 46>>t d{{zz#q!!!$$_BB t  '83388 A A A  ::c1  a & &sA . .q 11rc|pdrdkrdSgd}tfd|DS)NrrF)rz llama.cpp localhostz 127.0.0.1zlocal/zlocal:ggufz vllm-localc3 K|]}|vV dSrr)rEmarkerrCs rr^z&is_local_model_name..3s'::&v~::::::r)rrr)r local_markersrCs @ris_local_model_namer.sh  " # # % % + + - -D 46>>uoooM ::::M::: : ::r session_idrzmessagescrt}g}t}g}d}|D]}t|} || |drXt |d} || |ddkr|| |dpgD]=} t | } | r*|| || >t| r|dz }| } |dr4| dtj |dtzz } | t | d |} | }t!|d }t!|d d }t!|d }t!|d }||z}t!|d}t!|dd}t!|dddd}t!|d}t!|dt#t%j d| t$jz}t!|d}t!|dd}t!|dd}t!|dt#t%j d|z}t!|d}t!|dd}t!|dd}id |d!|pd"d#t#|d$t#|d%|d&t#|d'|d(|d)|d*|d+|d,|d-|d.|d/|d0t#|d1|id2|d3|d4|d5|d6|d7|d8|d9|d:t)t*| d;t*| rdnddt#t%j d?| t$jd@t#t%j dA| t$jdBt,| rt| rdnddCt,| rt.| rdnddD|r"t%jdE| t$jrdnddFt#t%j dG| t$jidHt| r-t#t%j dI| t$jnddJt#t%j dK| t$jdLt#t%j dM| t$jdNt#t%j dO| t$jdPt#t%j dQ| t$jdR|dSkr"t%jdT| t$jrdnddUt#t%j dV| t$jdWt#t%j dX| t$jdYt#t%j dZ| t$jd[t#t%j d\| t$jd]t#t%j d^| t$jd_t#t%j d`| t$jdat#t%j db| t$jdct#t%j dd| t$jdet#t%j df| t$jdgt#t%j dh| t$jdit#t%j dj| t$jt#t%j dk| t$jt#t%j dl| t$jt#t%j dm| t$jt#t%j dn| t$jt#t%j do| t$jt#t%j dp| t$jt#t%j dq| t$jtdrS)sNr tool_nameroletool tool_callsr )default r web_search web_extractrpatch read_file search_files write_file delegate_taskprocesszbackground\s*=\s*truecronjobimagevisionttstext_to_speechskillz\bskill skill_managememory mnemosynemnemosyne_rememberrrzzUntitled session message_counttool_call_countrdistinct_tool_count error_countterminal_calls web_callsweb_extract_callsrweb_browser_calls patch_callsfile_reads_searchesfile_tool_callsfiles_touched_countdelegate_calls process_calls cron_callsrrrrrr port_conflictrrztraceback|exceptionrz6gateway\.log|errors\.log|agent\.log|/api/logs|\blogs\brz0permission denied|eacces|operation not permittedrrrz\brestart|reload|kill|start\brzKmissing .*env|api key|environment variable|not configured|unauthorized|authrzyaml|yml|colon|parse errorrzRdocker.*(name|container).*already|container name conflict|Conflict\. The containerrz+\.(css|svg|tsx|jsx)|frontend|tailwind|reactrz%\.css|tailwind|style|className|visualrz.\bgit\s+(commit|push|merge|rebase|status|diff)rr{z#one character|single character|typorz#compress|context window|token|cacherz)gateway|discord|telegram|slack|api_serverrz7plugin|dashboard-plugins|__HERMES_PLUGIN|manifest\.jsonrzrollback|checkpointrz$docs|documentation|docusaurus|READMErzkmodel|provider|openrouter|codex|gemini|claude|anthropic|openai|mistral|qwen|deepseek|llama|ollama|vllm|ggufrrrrrzclaude|anthropicrzgemini|google ai|google modellocal_model_eventszCollama|llama\.cpp|gguf|vllm|local model|open[- ]weight|open weightszFtoolset|enabled_toolsets|browser tool|terminal tool|file tool|web toolzconfig\.ya?ml|\b[a-z0-9_-]+config\.(?:js|ts|json|ya?ml)|\.env(?:\b|\.)|manifest\.json|settings\.json|pyproject\.toml|package\.jsonzb\bgit\s+(rebase|merge|fetch|pull|push|tag|checkout)|merge conflict|conflict\s*\(|rebase --continuezapytest|unittest|vitest|playwright|npm test|pnpm test|node --check|py_compile|tests? passed|\bOK\bzDscreenshot|playwright|vision_analyze|browser_vision|\.png|image dataz>\bgit\s+tag|release|version bump|changelog|publish|pushed? tagz#cache hit|prompt caching|cache_read)rr!r#r%r'release_eventsr4 model_names)rdrappendrrKaddrERROR_REsearchrArQupdateFILE_REfindalljoinrrlenreIrPORT_RE INSTALL_RE SUCCESS_RE) rrzrr tool_sequence files_touchedfull_text_partsrrtextrCrblob full_textrrrrrrrrrrrrrrrrrrs ranalyze_messagesr6s 55J!M!eeM!#OK44}}t$$$ 77;   +s;'((D NN4 wwv&(($$T***GGL))/R + +D'--D +t$$$$$T*** ??4   1 K 77<  I C$*SWW\%:%:CHHHH HDW__T223333 /**I OO  E  ;;NM<GGI#M=AA y99M!M1mW55K%m[.QQ!-lGUcddO @@N y99C Kcenprpt@u@u%> EA7< 8 C +A9bd S STT9< : 3rz*cenprptuuvv;< < #C 3fhqsusw(x(x$y$y=< > Z%6%6y%A%A ghooV_F`F` gfg?< @ !z'8'8'C'C"k HYHYZcHdHd"k!!jkA< B %;&~29Eegprtrv;w;w&~aa}~C< D BJ/}@IKMKO%P%P!Q!QE< < < F `h`o`opy`z`zBS,I9VXVZ![![\\\ABG< H !#bj2GIRTVTX'Y'Y#Z#ZI< J #C 3aclnpnr(s(s$t$tK< L s2:.VXacecg#h#hiiM< N c"*%VXacecghhiiO< P ){a/?/?BINtvBDBFEGEG/?!!MNQ< R #bj)OQZ\^\`aabbS< T #bj)UW`bdbfgghhU< V RZ(bdmoqosttuuW< X 3rz*@)RTRRSSY< Z BJ/VXacecg$h$h i i[< \ BJ(VXacecghhii]< ^ SM9bd!K!KLL_< ` BJxBDAABBa< b RZ(;YMMNNc< d RZ(H)UWUYZZ[[e< f c"*-su~ACAE#F#FGGg< < hbj)rt}@B@DEEFFRZ)npy{}{@@AA!"*.SU^`b`d#e#eff2:'KMVXZX\]]^^ ,su~ACAE"F"FGGbj)jluwyw{||}}BJ'MyZ\Z^__``uuw< < < <r definition aggregatec |d}t||dpdt|dgd}fd|D}fd|D}|r|dd nd}|r|dd nd}|r|dd n|r|dd nd }|r|dd nd} td || z } |s|rd n8tdt d t j| z | z d z} t|} tdk} | rdn|dr| sdnd}| | p|d ||||| dS)Nr_rrIc|dSNrDrts rr z!evaluate_tiered..s 1[>rrc,g|]}|dk|SrDrrErprogresss rrFz#evaluate_tiered..s'DDDaQ{^)C)C)C)C)Crc,g|]}|dk|Srrrs rrFz#evaluate_tiered..s'EEE8a n+D+D!+D+D+DrrCrDrrncunlockedr discoveredrrr1tierr next_tiernext_threshold progress_pct)rMrremaxminmathfloorr)rr rJ tiers_listachieved next_tiersrrrcurrent_thresholddenompctrrr1rs @revaluate_tieredr(s * +F9==++0q11H w339Q9QRRRJDDDD:DDDHEEEEZEEEJ#+ 58B<  D)3= 1 f%%I3=uZ];//cmDtJrNS^D_D_stN5=D [111 >$55 6 6E }H }###aRhYjNjnsMswzLzA{A{9|9|2}2}CH~~Hhl##J" sJJZ^^H5M5M)rV`)rfrE 0Z*..QYBZBZ>ZejtxGO^g{I[^ _ __rc |dg}|s6d|d |drdndddddddSg}d}d}|D]}t||d dpd}t|d d}|p|dk}|o||k}|td |t d|z t jt|t|z d z} |rd n|dr|sdnd} ||p|d | d| dd |rd ntd| dS)NrwFrrrrrTrJrLg?rnrr) rrMrrrr r!rr) rr rwparts any_progresscomplete requirementrSrDr'r1s revaluate_requirementsr.s >>."55L h!Z^^H5M5M1Mdndrdrs{d|d|YOX`X`COY]kl{STfghh h ELH#:: IMM+h"7;;@qAA q1122 #0uqy 2 2 Sec!Y&7&77889999 *c%jj3u::-4 5 5C" uJJZ^^H5M5M)tVb)thtE 0\JNNS[D\D\@\glvzIL[_svOWHiHKHK]`aceh]i]i j jjrc t||d}|d|rdndd|rdnddd|rdnddS) NrJTrrrrrnr)rr)rr rs revaluate_booleanr0sIMM*X"67788H X?gzz[gquIQDXDEDEWXgk@YaRhRURUgh i iirztool calls in one sessionz)distinct Hermes tools used in one sessionzterminal calls in one sessionz&file/search/patch calls in one sessionz2web search/extract or browser calls in one sessionzmessages in one sessionzfiles touched in one sessionzlifetime delegate_task callsz&lifetime background process operationsz!lifetime scheduled-job operationsz(error/failed/traceback messages observedztraceback or exception mentionszlog inspectionsz#dev-server port conflict detectionszpermission-denied errorszpackage-install failuresz.successful package installs after package workz+restart/reload actions after error clustersz/missing auth/config/environment-variable eventszYAML/config parse incidentszDocker/container-name conflictsz(frontend/CSS/SVG/React activity mentionsz-CSS, styling, Tailwind, or className activityzgit workflow commandsz*tiny typo-style fixes after error clustersz!Hermes skill mentions or tool usez+skill_manage create/patch/delete operationszmemory or Mnemosyne tool eventszdurable memory writesz7context, compression, token, or cache-pressure mentionsz"gateway/API/chat-platform activityz-dashboard plugin development or usage signalsz%rollback/checkpoint recovery mentionsz"documentation/README/docs activityzmodel/provider-related activityzOpenRouter mentionszCodex mentionszprompt-cache/cache-hit mentionsz%lifetime web_search/web_extract callszlifetime web_extract callsz!lifetime browser automation callszlifetime Hermes tool callszlifetime terminal callszlifetime targeted patch editsz%lifetime read_file/search_files callsz%image generation or vision tool callsz"text-to-speech or voice tool callsz-distinct model names seen in session metadataz7distinct model providers inferred from session metadatazClaude/Anthropic model mentionszGemini/Google model mentionsz local/open-weight model mentionsz9Hermes sessions whose model metadata is local/open-weightztoolset or tool-family mentionsz+configuration/environment/manifest activityzAgit history operations such as rebase, merge, fetch, push, or tagz(test/check/verification command mentionsz:screenshot, Playwright, PNG, or vision-inspection activityz,release, version, publish, or git tag eventszHermes sessionszsessions started on weekendsz*sessions started late night or before dawn) rrrr!r#r%r'rr+r.r1c`t||ddS)N_r) METRIC_LABELSrreplace)rJs r metric_labelr5s&   VV^^C%=%= > >>rc|dr|ddkrdSd}d|vrmt|dgd}|s|d zSt|d}d d |D}|d |d |dzS|dpg}|r*d|D}|d zd|zdzS|dzS)Nrr1zSecret: exact requirement hidden until Hermes sees the first matching signal. Keep using Hermes across debugging, tools, memory, skills, plugins, and model workflows to reveal it.rr_rIc|dSr rr s rr zcriteria_for..s q~rrz1Requirement: use Hermes in the matching workflow.z, c3<K|]}|dd|dVdS)rCrrDNr)rErs rr^zcriteria_for..s8OOqai::!K.::OOOOOOrz Requirement: z. Tier ladder: .rwc g|]=}t|ddt|dd>S)rJu ≥ rLr)r5rMr)rErs rrFz criteria_for..#sFaaaqL8--JJCeQ4H4HJJaaarz; z3Requirement: complete the matching Hermes behavior.)rrer5r)r secret_prefixr"rJladderrwr*s r criteria_forr>s4~~hEJNN7$;$;x$G$GEEMZ''JNN7B77=U=UVVV  W #VV Vj);<==OOJOOOOOOvOOfOOOOO>>.117RLHaaT`aaa.51A1AACGG P PPritemct|}|ddkri|ddt|ddSt||d<|S)Nr1rz???zdSecret achievement: hidden until Hermes detects the first relevant behavior in your session history.)rCr[criteriar^rA)r`rr>)r?cleans rdisplay_achievementrC(s JJE yyX%%R%R8^lxy~llIQRRR R$U++E* Lrrlimitprogress_callback Optional[Any]progress_everyc  ddlm}n&#t$r}gid|ddddddcYd}~Sd}~wwxYwt}t |dt r|dni}d}d}||dkrd nt|} |} | | d d } t| } g} i}t| d D]l\}}|d}|st|}t |t r||nd}t |t r|dnd}t |t r|dnd}t |t r||krt |}|d z }nU| |}t||dp|dpd|}|d z }||d<|dp+|dp|dpd|d<|d|d<|d|d<|d|d<|dr |dtt |dtr<|dt#|dnt |dt$rft#|d|dvr;|dt#|dn&t#|dh|d<| ||t)|d||<|C|dkr=||zdkr4|| kr. |t%| || [#t$rYhwxYwnt+d tt-j|dt/| dd}|r |n##t/| dd}|r |wwxYw| t1| |dkrdndt| ||t| | d d!S)"uScan Hermes sessions and build per-session achievement stats. ``limit=None`` (the default) scans the ENTIRE session history. Prior versions capped this at 200, which silently reduced achievement totals to ~2% of history on long-running installs and made lifetime badges unreachable. SQLite's ``LIMIT -1`` means "unlimited"; we map ``None`` and non-positive values to ``-1`` so callers get the full catalog. Warm scans stay cheap: the checkpoint cache stores per-session stats keyed by ``(started_at, last_active)`` and only re-analyzes sessions whose fingerprint changed. Cold scans on large histories (thousands of sessions) take tens of seconds to several minutes; ``evaluate_all`` runs them on a background thread so the dashboard UI never blocks on the first request. ``progress_callback(partial_sessions, scanned_so_far, total)`` — when provided, fires every ``progress_every`` sessions with the sessions analyzed so far and progress counters. Background scans use this to publish intermediate snapshots so a long cold scan surfaces badges incrementally on each dashboard refresh instead of going all-at-once at the end. r) SessionDBzCould not import SessionDB: failedmodesessions_totalsessions_rescannedsessions_reused)rqr error scan_metaNrqrTF)rDinclude_childrenproject_compression_tipsr)startrZstats fingerprintrzr{r|rr2rxsourceryr)rVrUrnclose incrementalfullrLrMrNrOsessions_scanned_so_farsessions_expected_totalrqr rQ) hermes_staterIrDrsr_rr`rMlist_sessions_richr enumerater~ get_messagesrrrrdrrKrbrrWrurgetattraggregate_stats)rDrErGrIexc checkpointprevious_sessionsreused rescanneddb_limitdb sessions_metatotal_sessionsrqcheckpoint_sessionsidxrvsidfpcached cached_stats cached_fprUrrXs r scan_sessionsru0s6E******* EEER:^Y\:^:^v~STlmBCnDnDEE E E E E E EE!""J6@PZA[A[]a6b6bj z222hj FI muzzrrE H B8--Htns-tt ]++)+.0"=:::) ) IC((4..C $T**B3=>OQU3V3V`&**3///\`F2JJJJ D  ,,+     GT**   EGGGGT**   EGGGG $X..%+aZZMMV!(mm"+%'*8}}'5      sE ,',,$M:RP;9R; Q RQ  6R R=rqc  idt|ddddddddddddd dd dd dd dd dddddddddddddddddddddd }gd}|D]}d||<t}t}|D]}t|d|dd|d<t|d|dd|d<t|d|dd|d<t|d|dd|d<t|d|dd|d<t|d|dd|d<t|d |dd|d <t|d |dd|d <|d xx|ddz cc<|d xx|ddz cc<|d xx|ddz cc<|dxx|ddz cc<|dxx|ddz cc<|dxx|ddz cc<|dxx|d dz cc<|dxx|d!dz cc<|d"xx|d#dz cc<|d$xx|d%dz cc<|d&xx|d&dz cc<|d'xx|d'dz cc<|d(xx|d(dz cc<|D]&}||xx||dz cc<'||d)p t|d)p t}|D]5}t t |} | r|| 6td*|Dr|d+xxd,z cc<|d-r tj t|d-} | j d.kr|d/xxd,z cc<| j d0ks | j d1kr|d2xxd,z cc<#t$rYwxYwtd3|D|d4<t||d5<|S)6Nr+rTrrirrrrtmax_web_calls_in_sessionrurrrcrrrrrrz) rrrrrr rrr.r1)$rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr!r#r%r'rr4rrrrrrrrrrrrrrrrrrrrrc3NK|] }tt|V!dSr)rrK)rErs rr^z"aggregate_stats..s1UU "3z??33UUUUUUrrrr2r{r.r1c"h|] }||dk | S)rGr)rEms r z"aggregate_stats..s"&S&S&SQ&SqF{{q{{{rr r)rrdrrrrrKrrr localtimefloattm_wdaytm_hourrD) rqaggsum_keysrrprovider_namesssession_modelsrrlts rrdrdsX#Q ( "1  (  )!  #A +A '  A  1 "1 Q $Q!" #$ ! !#$%&7C:HCEEK"uuN ((+.s3N/OQRQVQVWhjkQlQl+m+m '(/237V3WYZY^Y^_tvwYxYx/y/y +,),S1J-KQUUSbdeMfMf)g)g %&/237V3WYZY^Y^_oqrYsYs/t/t +,03C8X4Y[\[`[`artu[v[v0w0w ,-*-c2L.MquuU`bcOdOd*e*e &'25c:\6]_`_d_dexz{_|_|2}2} ./.1#6T2UWXW\W\]rtuWvWv.w.w *+ Nquu]A666 155):A#>#>> "###quu-=q'A'AA### !%% Q"7"77 %&&&!%%0CQ*G*GG&&&    AEE-$;$;;    '(((AEE2G,K,KK((( "###quu-=q'A'AA### !"""aeeOQ&?&??""" 155q#9#99 Ooq 9 99 !!!QUU+?%C%CC!!! KAEE+q111 & &C HHHc1 %HHHH155//8355999}--6( - -J%c*oo66H -""8,,, UUnUUU U U 2 + , , , 1 , , , 55    ^E!%% *=*=$>$>??:??*+++q0+++:>>RZ2%5%5()))Q.)))     #&&S&S+&S&S&S"T"TC%(%8%8C!" Js4A5T++ T98T9crd|vrt||Sd|vrt||St||S)Nr_rw)r(r.r0)rr s revaluate_definitionrsHZ''z9555##$Z;;; J 2 22rc |sdS|d}dddddddd d }||vr\||t|fd  }|d |d|ddSdS)Nr_rrrrrrrr)rTrirrrrtrwrurc0|dS)Nrr})xrs rr zevidence_for..sc1 rrrrzr)rrzrS)rr)rrqrJmetric_to_session_keyrrs @r evidence_forrs t ^^. / /F%6)>#2)9*;$/,?(=  &&&#F+ 5555 6 6 6eeL11AEE'NNUVUZUZ[^`aUbUbccc 4rF is_partialscanrc `|di}|stndii}|di}tt j}g}t D]}t ||}|d} |sJ|drB| |vr>||dt||dgd|| <i||} |dr||| id| d<|| id p#t||dg| d <|t| |st|d |D} d |D} d |D} ||dg||d i|dt| t| t| t||d S)ugEvaluate every achievement definition against a scan result. Used by ``compute_all`` for finished scans AND by the background progress callback for partial, in-flight snapshots. ``is_partial=True`` skips persisting ``state.json`` unlocks — we don't want to record an "unlock time" based on half a scan that a later session might shift. r r?rZrrrq) unlocked_at first_tierevidencerrc"g|] }|d | SrrrEas rrFz&_compute_from_scan..,s!666a* 6666rcDg|]}|ddk|S)r1rr}rs rrFz&_compute_from_scan..-s,III!%%..L*H*H!*H*H*HrcDg|]}|ddk|S)r1rr}rs rrFz&_compute_from_scan...s, A A AAaeeGnn&@&@a&@&@&@rrQrP achievementsrqr rQrPunlocked_countdiscovered_count secret_count total_countrp) rrFrrrMrr5rrrrCrRr)rrr r1r?r evaluatedrresult unlock_idr?rrrs r_compute_from_scanrssb))I * ?JLLLBEy"--G dikk  CI" 4 4 $Z;;t$  XfZ0 XYg5M5M14FJJvDVDVdpq{~B~F~FGQSU~V~VeWeW"X"XGI '*'' *  @")++i"<"<"@"@"O"OD &{{9b99==jII\Zdfjfnfnoy{}f~f~MMD ,T223333 5669666HIIYIIIJ A A A A AF!HHZ,,XXk2..'""h-- OOF 9~~   rcFt||}t|dS)N)rErGFr)rur)rErGrs r compute_allr=s( +<^ \ \ \D du 5 5 55rzOptional[threading.Thread]_BACKGROUND_SCAN_THREADc dtD}|gidddddddtd|Dtd|Dt||d S) zPlaceholder payload used while the first-ever scan is still running. Returns a structurally-complete response so the dashboard UI can render an empty achievement list + spinner without special-casing "no data yet". c2g|]}ti|dd|drdnddd|dpigdd|dpigddddd S) FrrrrIrCrDrN)rrr1rrrrr)rCr)rEds rrFz+_build_pending_snapshot..LsPPP~$&x&x%uklkpkpqykzkz`M_g_gAM[\no@DDELMMURTQUWX~Y~]~]^d~e~ez{zz@GzHzHzPMOLPRSyTyXyXYdfgyhyhrv.w.w&xyyPPPrpendingrrKNc3LK|]}|ddkdV dS)r1rrNr}rs rr^z*_build_pending_snapshot..Ts6WWag,8V8V8V8V8V8VWWrc3LK|]}|ddkdV dS)r1rrNr}rs rr^z*_build_pending_snapshot..Us6OO!AEE'NNh4N4NA4N4N4N4NOOrr)r5rr)rrs r_build_pending_snapshotrFs PPCOPPPI!'1TUjkllWW9WWWWWOOyOOOOO9~~   rpublish_partial_snapshotsc jt5ttj}dtd<|td<dtd<d}|r|nd} t |}t |att dpttjatt d td<n8#t$r+}d td<t|td<Yd}~nd}~wwxYwttjtd <ttd |z d ztd <ttdddztd<n#ttjtd <ttd |z d ztd <ttdddztd<wxYw ddddS#1swxYwYdS)u*Execute a scan + snapshot update. Called synchronously or from a thread. When ``publish_partial_snapshots=True`` (the default for background scans), the scanner periodically publishes an in-progress snapshot to ``_SNAPSHOT_CACHE`` so each dashboard refresh during a long cold scan shows more progress — badges unlock incrementally as sessions stream in, instead of staying at zero for minutes and then jumping to the final state. Synchronous /rescan callers pass ``False`` because they block on the full result anyway. runningr1r2Nr4c  |t|d|dd||dd}t|d}t|adadS#t $rYdSwxYw)N in_progressrr[r^Tr)rdrrWr/rrD)partial_sessionsscanned_so_fartotal partial_scanpartials r_publish_partialz4_run_scan_and_update_cache.._publish_partialms  0!01A!B!B -*8./+,3A38 ""   -\dKKK #-W"5"5%&"""    s>>H(22O!$_%8%8%H%H%\CPTPYP[P[L\L\!]!]  / * * *$*L ! ! 2 2 2$,L !),SL & & & & & & 2+.dikk*:*:L '/2L4ORY4Y]a3a/b/bL+ ,(+L,<,<[!,L,L(M(MPQ(QL % %+.dikk*:*:L '/2L4ORY4Y]a3a/b/bL+ ,(+L,<,<[!,L,L(M(MPQ(QL % Q Q Q Q %].R.R.R.R.R.R.R.R.R.R.R.R.R.R.R.R.R.RsQAH(BCF D  !DFD  FBH(BHH((H,/H,ct5t}|"|r ddddStjt ddidd}|a|ddddS#1swxYwYdS)aKick off a scan in a daemon thread if one isn't already running. Idempotent: concurrent callers see the in-flight thread and return immediately. The thread updates ``_SNAPSHOT_CACHE`` on completion so subsequent ``/achievements`` requests see fresh data. While running, it also publishes partial snapshots every ~250 sessions so the UI reflects incremental progress on long cold scans. NrTzhermes-achievements-scan)targetkwargsrCr)_BACKGROUND_SCAN_LOCKris_alive threadingThreadrrT)existingthreads r_start_background_scanrs   *  H$5$5$7$7          !-/6+     #)                   sA65A66A:=A:forcec ttj}|st|r tpiStMt }t |t r*t|dpd}|a|p|a|r-tdttSt|St$t|sttStt|S)uReturn the current achievements payload. Behavior matrix: * Fresh in-memory cache → return it instantly. * Stale on-disk snapshot → load it, kick a background rescan, return the stale data (UI decorates it with ``is_stale=True``). * No snapshot yet (first-ever run) → kick a background scan, return an empty-but-valid "pending" payload so the UI can render a spinner without blocking. * ``force=True`` (manual /rescan) → run synchronously, block the caller, replace the cache. Warm scans stay cheap (the checkpoint cache reuses per-session stats). Cold scans on 8000+ session databases take minutes; the background thread prevents that from ever blocking the dashboard request path. NrprF)r) rMrrr/rir_r`rrrrr)rr persistedrps r evaluate_allrs& dikk  C %_S))%$"$!OO i & & 5y}}^<<ABBL'O!-!4  , #UCCCC  &" "&s+++"s## % " $ $ $  "3 ' ''rz /achievementscKtfddD}t|d<idpidti|d<|S)Nc*i|]}|v||Srr)rErXrhs rrZz achievements..sP```aVW[_V_V_q$q'V_V_V_r)rrrrrrPrpis_stalerQstatus)rrrr)payloadrhs @rrrs >>D````$R```G,T22GJ 88K &B&((GK Nrz /scan-statusc"KtSr)rrrr scan_statusrs  ! !!rz/recent-unlockscxKt}td|dDddddS)Nc"g|] }|d | Srrrs rrFz"recent_unlocks..s!DDDa mD1DDDrrc0|dpdS)Nrrr})rs rr z recent_unlocks..sTUTYTYZgThThTmlmrT)rreverser )rre)rhs rrecent_unlocksrs[ >>D DDd>2DDDJmJmw{ | | |~AA~A BBrz/sessions/{session_id}/badgesc4Kt}tfd|dDd}|sgdSt|g}g}tD]@}t ||}|dr&|t i||A|dS)Nc34K|]}|dk|VdS)rNr)rErrs rr^z!session_badges..s1QQ!1\?j3P3PA3P3P3P3PQQrrq)rbadgesr)rnextrdr5rrrC)rrhsessionr rrrs` rsession_badgesrs >>DQQQQtJ/QQQSWXXG 8(B777 **I F"II $Z;; *  I MM-.F.Fv.FGG H H H$ 7 77rz/rescanc.KdditdS)NokT)r)rrrrrescanr s! $ 3,T222 33rz /reset-stateclKtdiidadadtd<dtd<dtd<dtd<dtd< t d n#t $rYnwxYw td n#t $rYnwxYwd d iS) Nr?rr0r1r2r3r4r5T) missing_okr)rRr/rr8r;unlinkrDr=rrr reset_staters 2O"L!%L"&L!%L'+L#$ $////         D 1111      $<s$ "A.. A;:A;?"B"" B/.B/)r r)r>r?r r@)rJrKrLrMr r7)r r7)r1r7r rG)rSrr r)r r.)rhr7r rG)rvr7r r7)rrMr rr)rr.rrr r)rrr r7)rrr r)rr7r rK)rrrrKr rM)rrKr r)rrKr r)rrKrzrKrr@r r7)rr7r r7r r7)rJrKr rK)rr7r rK)r?r7r r7)NNr)rDrrErFrGrMr r7)rqr@r r7)rr7rqr@r r.)rr7rrr r7)Nr)rErFrGrMr r7)rrMr r7)T)rrr rG)r rG)F)rrr r7)rrK)Z__doc__ __future__rrAr rrrpathlibrtypingrrrrr hermes_constantsr ImportErrorosrfastapirrDrrLockrr/__annotations__rr8compilerrrrrrrHrIrPr5r9r;r=rFrRrWrirlrsrur~rrrrrrrrrr(r.r0r3r5r>rCrurdrrrrrrrrrrrrrrrr)rrrrrrs$#"""""  11111111111111=0000000========== !!!!!!!!!!!!!!!!!!!!!!  Y^   ,00000      2:PRTRV W W "*vxzx| } } RZH"$ O O RZjlnlp q q "*s t t @ @ @ cccc****N& >CCQakyCJ`{FKFKLhLhLhFiFijjN& "+ASZhxBLVawITYTYZzZzZzT{T{||N& '9KGUeo}GNdCNSNSTiTiTiNjNjkk N&  =AO_izDL_b_bcBDG_H_HJMJMNnpsJtJtvyvyz\^`vava^bcc N& )=NpOYcmuKalqlqrJrJrJlKlKLL N& (1M_esCMWaiT_d_deBeBeB_C_CDDN& '9JzIYcmw~TfqvqvwWwWwWqXqXYYN& "+ASN\mwAKTjxCHCHIjIjIjCkCkllN& #,CUFTeoyCI_q|A|AB`B`B`|a|abbN& $-EWESdnxBJ`q|A|ABbBbBb|c|cddN& &:LUct~HRXdh~T_d_de}e}e}_~_~N& +4L]~M^hr|BNRhBMRMRSkSkSkMlMlmmN& %.GYN\mwHRatwtwxNPRtStSUXUXYqsuUvUvswxx!N&" $-HZWev@Q[dwzwz{WY[w\w\^a^abprv^w^wvxyy#N&$ )=OZhyCMW\hlBXchchiMiMiMcNcNOO%N&& !*?PrAR\fpwCG]p{@{@AaAaAa{b{bcc'N&( #,CUJXis}GR^bxP[`[`a{a{a{[|[|}})N&. "+J\FTakyCRhALQLQRnRnRnLoLopp/N&0 #,CUcq~HV`h~^ininoKoKoKiLiLMM1N&2 %5FzIV`nxCYwBGBGHeHeHeBfBfgg3N&4 >BvER\fpwMgrwrwx^x^x^r_r_``5N&6 "+BS}LYct~DWZWZ[gikWlWlnqnqrMORnSnSVTUU7N&8 >BvER\fp~Titytyz_z_z_t`t`aa9N&: (;MFTak|FNZ^qtqtuUWXqYqY[^[^_mos[t[tpuvv;N&@ >uDS]gq@VdototuYuYuYoZoZ[[AN&B '0M_bpIS]dzOZ_Z_`x`x`xZyZyzzCN&D ODyHWaku~TcnsnstPtPtPnQnQRREN&F ODkzIS]goEZejejkGkGkGeHeHIIGN&H %5GO]lv@JRhxCHCHImImImCnCnooIN&J &7HzIXblvUepupuvZvZvZp[p[\\KN&L ODN]gq{CYhsxsxyYyYyYsZsZ[[MN&N &7HtCR\fpxDH^ozz@_@_@_z`z`aaON&T #,CU\jxBLV^tEPUPUVtVtVtPuPuvvUN&V &7H~M[eoy@Vozz@\@\@\z]z]^^WN&X )=OAO]gq{DZp{@{@AeAeAe{f{fggYN&Z )=OAO]gq{DZitytyzTzTzTtUtUVV[N&` &7HkzHR\fpF\glglmLmLmLgMgMNNaN&b >BrAOYcmsI\glglmJmJmJgKgKLLcN&d )=ODR`jt~F\wBGBGHgHgHgBhBhiieN&f &7IGUcmwAF\p{@{@A]A]A]{^{^__gN&h "+ASDR`jt~DZepupuvMvMvMpNpNOOiN&n >CCQ]gq{AWepupuv[v[v[p\p\]]oN&p )=NNZdnx@VitytyzWzWzWtXtXYYqN&r %5GDR^hr|CYgrwrwxWxWxWrXrXYYsN&t '9KM[gq{ELbxCHCHI^I^I^C_C_``uN&v (;M`nzDNX_uKV[V[\o\o\oVpVpqqwN&x (;MHVblv@F\u@E@EFVFVFV@W@WXXyN&z &7ILZfpzDJ`ny~y~\\\y]y]^^{N&| '9KJXdnxBI_ny~y~YYYyZyZ[[}N&~ !*?QKYeoyCLbq|A|AB\B\B\|]|]^^N&@ "+ASao{EOYcyT_d_dexexex_y_yzzAN&F "+AS_m|FPZcyITYTYZrZrZrTsTsttGN&H %5GftCMWaf|KV[V[\y\y\yVzVz{{IN&J %5GO]jt~HPfzEJEJKbKbKbEcEcddKN&L '9KYguIS[q~ININOjOjOjIkIkllMN&N (;M[iwAKUZpCNSNSTnTnTnNoNoppON&T (;L}LWakuUdototuOuOuOoPoPQQUN&V &7IFT_is}G]ozz@X@X@XzYzYZZWN&X "+ASBP[eoyUepupuvNvNvNpOpOPPYN&Z #,CUDR]gq{BNRhvAFAFGcGcGcAdAdee[N& NNNNbPPPPXXXXZZZZAAAA     LLLL DDDD"LLLL ^^^^11111$....    SSSS 2 2 2 2;;;;mmmm`____$jjjj$iiii ?!<?#%P?$%D?%&N ? '(\ ? 8 ?#$B?:?C?;?>?9?(?A? :? 6!?"N#??$!"O%?&M'?(6)?*?+?, J-?.J/?0)1?2%&R3?475?6H7?869?:2;?<O=?>:??@DA?B>C?D@E???F5G?H.I?J$K?L5M?N>O?P;Q?R8S?T4U?V5W?X8Y?Z !H[?\A]?^5_?`Ka?bXc?d6e?f3g??h=!\7B]=UD&6B}??? D????QQQQ$ '+ooooodQQQQh3333*DI''''''T66666 7;::::& ((*:R:R:R:R:Rz04(4(4(4(4(nON""" BBB  +,, 8 8 8-, 8Y444^s!:A  A AA+*A+