@litfamily/lithermes 1.0.23 → 1.0.25

package/assets/lithermes-plugin/payload-version.json

@@ -1,7 +1,7 @@
 {
-  "syncedAt": "2026-10-15T09:46:03.900Z",
+  "syncedAt": "2026-10-18T09:42:50.174Z",
   "source": "bundled-payload",
-  "sourceHash": "164f684b1b783534bf9b71f657f9e9d86b321e018c4a1ac02e7abe3cf604edd6",
+  "sourceHash": "91ef78ac52df745352ac069cd0872ee6a17253c4fa55b5577e52482b9b329971",
   "files": [
     {
       "path": "NOTICE.md",
@@ -9,11 +9,11 @@
     },
     {
       "path": "README.md",
-      "sha256": "03256264acbaba328e51b82a527fe511db7f4ff907d0a74762bdaf0baadc8e20"
+      "sha256": "882eb72644fe3bab11a110196dd6692d74ee51525f75e64a7cfa04e3c658de60"
     },
     {
       "path": "__init__.py",
-      "sha256": "76cf72655600b82544e9047fab1f5f4030927803c0cfbc08fca311204f37d32c"
+      "sha256": "057f8d630323ac427a48749c05cbd23076810fb66fa78821c6ab16076574127c"
     },
     {
       "path": "auto_handoff.py",
@@ -21,7 +21,7 @@
     },
     {
       "path": "auto_update.py",
-      "sha256": "ff05a5c11ecdfb397e57c49b71aff24d6e3455e5be298c4c9c2de301dcc64333"
+      "sha256": "ba2beba07210ccd934ddc5902a5054a8fbe0f5bb9dcd9e9019196551bf4ea92b"
     },
     {
       "path": "bounded_work.py",
@@ -33,7 +33,7 @@
     },
     {
       "path": "core.py",
-      "sha256": "b431f7341d6e82badd752fe1ac56fd39d309f06159f13cbbfc5124728d5fa8f5"
+      "sha256": "44ea3860657ebe8dc335ccefb613ad21700b725ba0f4cb60a1cf81da18f61ff5"
     },
     {
       "path": "core_commands.py",
@@ -41,11 +41,11 @@
     },
     {
       "path": "core_contexts.py",
-      "sha256": "5c31f1c73cd4c3757883f5fc9945ccac26856a98cc1f989853db1f29441711fc"
+      "sha256": "4923e1e9f72e52c6c83e19adaab835b6bccd1de6a3943f3275483c5b42eea7d8"
     },
     {
       "path": "core_contract.py",
-      "sha256": "f4ad205e6da5788520ed46d3aacf805bda4a95d930fad2a6b0633a749e777732"
+      "sha256": "532d73146aaff3e5e2553195b0d08a941bd1c90b4ec29539dd00f5904075cb02"
     },
     {
       "path": "core_plans.py",
@@ -73,7 +73,7 @@
     },
     {
       "path": "core_runs.py",
-      "sha256": "24e484ceebad1726834535949e89667f4dee1ec78bc0a977d03ec438cc9e0037"
+      "sha256": "066d605fef75c8f2959f7ab7586f144bbd5e43916075ccba6a9608e5ece7d986"
     },
     {
       "path": "core_runtime.py",
@@ -85,11 +85,11 @@
     },
     {
       "path": "deliverable_hedge_guard.py",
-      "sha256": "804cf1253064e94ac19db45df03a5eb2ed68ef968fe1658c720d56159bf29048"
+      "sha256": "084eb4381d8be3055eada034bf0c3c31339b9c766cbf3b19fd85042e2e254039"
     },
     {
       "path": "diagnostics.py",
-      "sha256": "88d7b76438c82755fb9456882994ab4efd70c889705c04095e5a12d1759425fb"
+      "sha256": "1fd173995dd1abc1d58cc719ecd351f91bd1c65c9056fdffa064fda684f18318"
     },
     {
       "path": "handoff.py",
@@ -97,7 +97,7 @@
     },
     {
       "path": "humanizer_detector.py",
-      "sha256": "bca68ebaad84ab2fec5a41a91f293abe9e194011669ef03386611c8412561e97"
+      "sha256": "48e4f3a02326521769ac193b858eecbb90773cb765aa8d5794ffaa3c1dee2d62"
     },
     {
       "path": "humanizer_ko_metrics.py",
@@ -107,10 +107,6 @@
       "path": "humanizer_office.py",
       "sha256": "97ea96c5eb688e298d57ba7991bbd4bd8d92f969a2ad608add877aefa5de7128"
     },
-    {
-      "path": "jev_hint.py",
-      "sha256": "77238cf88d875f3c1945ad26bf9699c81933711ff675dc19df48215d58884c33"
-    },
     {
       "path": "knowledge.py",
       "sha256": "ef11fb0f568ae191809a81eb19015f8a3c8d2141d141e3453bd7f8b515a9a8b0"
@@ -181,7 +177,7 @@
     },
     {
       "path": "plugin.yaml",
-      "sha256": "92d263e3abf96c4533db6814cfb6a104f3a8822e3de205106eaa4edff1c76338"
+      "sha256": "d9eae351c038cfaff91980666d4d3ebe8f2ad82f31bf8ef9539fb4c4ad088e84"
     },
     {
       "path": "provider_metrics.py",
@@ -1285,7 +1281,7 @@
     },
     {
       "path": "skills/frontend-ui-ux/references/complete-contract.md",
-      "sha256": "f872ab0d5e2c5a99c40fec7630df67c45c23a927b562fd35943e404204e756aa"
+      "sha256": "df99f8f532c06232220537041128d8a5480bb60aedbbe3af8909444aaa8944ac"
     },
     {
       "path": "skills/frontend-ui-ux/references/composition.md",
@@ -3277,7 +3273,7 @@
     },
     {
       "path": "skills/lit-humanizer/SKILL.md",
-      "sha256": "1df63514da5f9295578c3fc7ff475ae911da2310ed43ca3e794759dc4414b66a"
+      "sha256": "47c562a344c89d16be5271f86874af556991dd5c9a26f45e0800eda5a08f5381"
     },
     {
       "path": "skills/lit-humanizer/assets/report-skeleton.md",
@@ -3513,11 +3509,11 @@
     },
     {
       "path": "skills/lit-humanizer/references/taxonomy.md",
-      "sha256": "d0958c702eb531f82612ff48d16134afbfd6c65b40bc80ebc4bce778a02b4238"
+      "sha256": "7bdda99ad8f2e1358b70f96e017d5a70b879251b4681f8752babaf7598030239"
     },
     {
       "path": "skills/lit-humanizer/rules.json",
-      "sha256": "806e8caaeea25b34fa7a2caf8957a4af6fe95e557d5db71fa6d6e90fcea7091c"
+      "sha256": "61f494bbbd9dee707b96b50308bf9c045d6b268218a442b3022b1c29194bb95c"
     },
     {
       "path": "skills/lit-humanizer/scripts/detect.py",
@@ -4405,7 +4401,7 @@
     },
     {
       "path": "skills/visual-qa/references/complete-contract.md",
-      "sha256": "daa71196ff16fc545fdaad07367cdcd425c9e5cd3cbcb10e20f28ba10f1c3be3"
+      "sha256": "16ccc6a685865e00a226fbdbbdf1d4e170ca9c37731a94974ea135f281032e51"
     },
     {
       "path": "skills/visual-qa/schemas/evidence-manifest-v1alpha1.schema.json",

package/assets/lithermes-plugin/plugin.yaml

@@ -1,5 +1,5 @@
 name: lithermes
-version: 1.0.23
+version: 1.0.25
 description: "Hermes-native workflow toolkit: litgoal durable runtime, 5-lane review orchestrator, Litwork commands, skills, and prompt steering."
 author: "LitHermes contributors"
 kind: standalone
@@ -10,6 +10,7 @@ hooks:
   - pre_tool_call
   - pre_command
   - post_tool_call
+  - transform_tool_result
   - post_api_request
   - subagent_stop
   - transform_llm_output
@@ -33,6 +34,7 @@ provides_hooks:
   - pre_tool_call
   - pre_command
   - post_tool_call
+  - transform_tool_result
   - post_api_request
   - subagent_stop
   - transform_llm_output

package/assets/lithermes-plugin/skills/frontend-ui-ux/references/complete-contract.md

@@ -445,7 +445,7 @@ isolated Hermes home. Use `--hermes-home`; never `--home`.
 
 ```text
 $ node packages/lithermes-installer/bin/lithermes.js install --yes --offline --no-hud --hermes-home "$ISOLATED"
-Installed LitHermes 1.0.23
+Installed LitHermes 1.0.25
 plugin: $ISOLATED/plugins/lithermes
 model config: updated
 
@@ -462,7 +462,7 @@ installed payload: PASS
 enabled config: PASS
 
 $ hermes lithermes doctor
-[OK] plugin.yaml readable (version 1.0.23)
+[OK] plugin.yaml readable (version 1.0.25)
 [OK] skills bundled: 36
 [OK] litgoal durable runtime importable
 ```

package/assets/lithermes-plugin/skills/lit-humanizer/SKILL.md

@@ -21,7 +21,7 @@ identity:
   invocation: "lithermes:<frontmatter.name>"
 surfaces:
   manifest: plugin.yaml
-  python_entrypoints: ["__init__.py:register", "core.py:pre_llm_call", "deliverable_hedge_guard.py:pre_tool_call"]
+  python_entrypoints: ["__init__.py:register", "core.py:pre_llm_call", "deliverable_hedge_guard.py:pre_tool_call", "deliverable_hedge_guard.py:transform_tool_result"]
   bundled_rule: rules/bundled-rules/lit-humanizer.md
   detector: skills/lit-humanizer/scripts/detect.py
 state:
@@ -60,7 +60,7 @@ after_payload_edit: "npm --prefix packages/lithermes-installer run sync-plugin -
 
 For a file edit, the Hermes `pre_tool_call` guard blocks block-tier findings in added text passed to `write_file` or `patch` for Markdown, HTML, text, TeX, CSV, SVG, reStructuredText, and AsciiDoc files. Warn-tier findings arrive as advisory context. Fenced code, inline code, exact quoted user spans, and internal `plans/`, `evidence/`, `HANDOFF*`, ledger, `.lit*/`, and `.hermes/` paths are excluded. The guard never scans unchanged file text. Use `write_file` or `patch` for prose edits when pre-save checking is required.
 
-DOCX/PPTX/PDF checks happen after a supported file-write event or when a script-like tool reports an explicit output path in its result. Hermes' `post_tool_call` is observer-only, so a finding cannot undo a completed export: revise the source and rebuild the file. DOCX/PPTX extraction uses Python's standard-library ZIP/XML support. PDF extraction uses host `pdftotext` when present; if it is unavailable or fails, the scan fails open and reports that boundary. Script-created files without a reported output path are outside automatic post-write inspection; run the detector explicitly after such a write.
+DOCX/PPTX/PDF checks happen after a supported file-write event or when a script-like tool reports an explicit output path in its result. Hermes' `post_tool_call` is observer-only, so a finding cannot undo a completed export: revise the source and rebuild the file. DOCX/PPTX extraction uses Python's standard-library ZIP/XML support. PDF extraction uses host `pdftotext` when present; if it is unavailable or fails, the scan fails open and reports that boundary. A DOCX, PPTX or Markdown file that a `terminal` or `execute_code` call builds is checked when that call returns: Hermes' `transform_tool_result` hook finds files modified while the call ran (the reported or session working directory, `workdir`, and folders of paths named in the command, code or output; bounded depth, file count and size, internal paths skipped) and, on a block-tier finding, puts `LIT_HUMANIZER_SCRIPT_DELIVERABLE_BLOCK` with the rule ids in that tool result's `error` field. The command's exit code stays as it ran, and the file stays on disk: edit the build source and rebuild before presenting it. A file written outside those folders, deeper than the scan, or by a background process after the call returned is not seen; run the detector on it explicitly.
 
 ## #contract.language_and_scope
 

package/assets/lithermes-plugin/skills/lit-humanizer/references/taxonomy.md

@@ -17,7 +17,7 @@ This original category comes from the 26 real lines in `examples/detector-valida
 - ko-bracket-status-tag and en-bracket-status-tag — ko/en, block. Replace bracket keys with a sentence describing the status.
 - ko-standalone-scope-disclaimer and en-standalone-scope-disclaimer — ko/en, block for stock disclaimers. Preserve a user-requested legal, medical or safety notice and place it once where it applies.
 - ko-status-negation (also catches 쓰지, 않습니다/않았습니다 endings and bold-wrapped endings), ko-mi-status, en-epistemic-negation and en-not-performed — warnings. A negative result or unperformed action may be the finding. Write the actor, scope and verb plainly; never turn unknown into false or an estimate into a fact.
-- ko-negative-pledge and en-negative-pledge — ko/en, block. A line that tells the reader what the document, a table or a number is not for (`동일 조건의 독립 성능 비교로 쓰지 않음`, `This is not intended as a head-to-head benchmark`) is a pledge to the reader. Move it to the chat reply, or restate the real limit as a data fact beside the number ("샘플은 한 공정 조건만 포함한다"). Operating rules, method lines and legal or financial notices ("원금을 보장하지 않습니다", "not a substitute for professional advice") are not pledges and pass; so does a negative finding such as 수율을 개선하지 않았다.
+- ko-negative-pledge and en-negative-pledge — ko/en, block. A line that tells the reader what the document, a table or a number is not for (`동일 조건의 독립 성능 비교로 쓰지 않음`, `This is not intended as a head-to-head benchmark`) is a pledge to the reader. Move it to the chat reply, or restate the real limit as a data fact beside the number ("샘플은 한 공정 조건만 포함한다"). Operating rules, method lines and legal or financial notices ("원금을 보장하지 않습니다", "not a substitute for professional advice") are not pledges and pass; so does a negative finding such as 수율을 개선하지 않았다. The same refusal covers the phrasings a model reaches for next (`이 표는 순위가 아닙니다`, `숫자끼리 서로 비교할 수 없습니다`, `This table is not a ranking`), while a plain instruction such as `Do not compare these values directly; convert to SI first` or a unit-mismatch rule is an operating rule and passes. A quote line is skipped unless it opens with a bold label (`> **주의:** …`); that is the author's own callout and is read like any other line.
 - ko-negative-pledge-repeat — ko, block, whole-text scope. Two or more sentences ending in 해석하지/주장하지/대표하지 + 않음, or in a claim noun + 이/가 + 아님, make a disclaimer list. One such sentence stays with the warning above.
 - ko-plain-meta-label-warn and en-plain-caveat-label — warnings for boundary headings. They may be useful in internal or technical packets.
 - en-knowledge-cutoff, en-ai-self-disclaimer, en-hope-helps and ko-chatbot-signoff — block. Remove the model wrapper or generic sign-off, then retain the answer.

package/assets/lithermes-plugin/skills/lit-humanizer/rules.json

@@ -884,14 +884,15 @@
       "id": "ko-negative-pledge",
       "lang": "ko",
       "severity": "block",
-      "pattern": "(?<![가-힣])(?:이|본|해당|위|아래)\\s+(?:자료|문서|보고서|슬라이드|덱|표|그림|그래프|차트|수치|결과|비교|분석|내용|예시)(?:은|는)\\s[^.!?\\n]{0,40}?(?:(?:해석하|의미하|주장하|대표하)(?:지\\s*(?:[*_]{1,2}\\s*)?(?:않(?:음|는다|습니다)|말\\s*것|마세요|마십시오)|(?:으)?면\\s*(?:[*_]{1,2}\\s*)?안\\s*(?:됨|된다|됩니다))|(?:(?:비교|결론|벤치마크|순위|대표값|일반화)(?:이|가)|목적이|위한\\s*것이)\\s*(?:[*_]{1,2}\\s*)?(?:아님|아니다|아닙니다)(?![가-힣]))|(?:비교|결론|벤치마크|순위|대표값|일반화)(?:으로|로)\\s*(?:[*_]{1,2}\\s*)?(?:쓰|사용하|해석하|읽|간주하|인용하)(?:지\\s*(?:[*_]{1,2}\\s*)?(?:않(?:음|는다|습니다)|말\\s*것|마세요|마십시오)|(?:으)?면\\s*(?:[*_]{1,2}\\s*)?안\\s*(?:됨|된다|됩니다))|(?:공개|배포|대외|외부|홍보|발표|보고|비교|인용|공식)용\\s*(?:자료|문서|수치|표|그래프)(?:이|가)\\s*(?:[*_]{1,2}\\s*)?(?:아님|아니다|아닙니다)(?![가-힣])",
+      "pattern": "(?<![가-힣])(?:이|본|해당|위|아래)\\s+(?:자료|문서|보고서|슬라이드|덱|표|그림|그래프|차트|수치|결과|비교|분석|내용|예시)(?:은|는)\\s[^.!?\\n]{0,40}?(?:(?:해석하|의미하|주장하|대표하)(?:지\\s*(?:[*_]{1,2}\\s*)?(?:않(?:음|는다|습니다)|말\\s*것|마세요|마십시오|말아\\s*주(?:세요|십시오))|(?:으)?면\\s*(?:[*_]{1,2}\\s*)?안\\s*(?:됨|된다|됩니다)(?![가-힣]))|(?:(?:비교|결론|벤치마크|순위|대표값|일반화)(?:이|가)|목적이|(?:위한|려는)\\s*것이)\\s*(?:[*_]{1,2}\\s*)?(?:아님|아니다|아닙니다)(?![가-힣])|순위표(?:이|가)\\s*(?:[*_]{1,2}\\s*)?(?:아님|아니다|아닙니다|아니고)(?![가-힣]))|(?:비교|결론|벤치마크|순위|대표값|일반화)(?:처럼|으로|로)\\s*(?:[*_]{1,2}\\s*)?(?:쓰|사용하|해석하|읽|간주하|인용하)(?:지\\s*(?:[*_]{1,2}\\s*)?(?:않(?:음|는다|습니다)|말\\s*것|마세요|마십시오|말아\\s*주(?:세요|십시오))|(?:으)?면\\s*(?:[*_]{1,2}\\s*)?안\\s*(?:됨|된다|됩니다)(?![가-힣]))|(?:공개|배포|대외|외부|홍보|발표|보고|비교|인용|공식)용\\s*(?:자료|문서|수치|표|그래프)(?:이|가)\\s*(?:[*_]{1,2}\\s*)?(?:아님|아니다|아닙니다)(?![가-힣])|(?<![가-힣])(?:숫자|수치)(?:들)?(?:은|는|이|가|을|를|끼리|도)(?![가-힣])(?:(?!면\\s)[^.!?\\n]){0,40}?(?<![와과]\\s)(?<![와과])비교할\\s*수\\s*(?:는\\s*)?없(?:다|습니다|음|나)(?![가-힣])|(?<![가-힣])(?:숫자|수치)(?:들)?끼리\\s*(?:서로\\s*|직접\\s*)?비교(?:해서|하여|해)\\s[^.!?\\n]{0,30}?[\"”’']\\s*(?:는|라는)\\s*결론[^.!?\\n]{0,8}?(?:수\\s*없(?:다|습니다)(?![가-힣])|(?:으)?면\\s*(?:[*_]{1,2}\\s*)?안\\s*(?:됨|된다|됩니다)(?![가-힣]))|(?:(?<![가-힣])(?:숫자|수치)(?:들)?|(?<![가-힣])(?:이|위|아래|본)\\s+(?:표|값|자료|그래프|차트))[^.!?\\n]{0,40}?(?:빠르|느리)다고\\s*판단하(?:지\\s*(?:[*_]{1,2}\\s*)?(?:말\\s*것|마세요|마십시오|말아\\s*주(?:세요|십시오))|(?:으)?면\\s*(?:[*_]{1,2}\\s*)?안\\s*(?:됨|된다|됩니다)(?![가-힣]))|(?:빠르|느리)다[\"”’']?\\s*(?:는|라는)\\s*식으로\\s*읽(?:지\\s*(?:[*_]{1,2}\\s*)?(?:말\\s*것|마세요|마십시오|말아\\s*주(?:세요|십시오))|(?:으)?면\\s*(?:[*_]{1,2}\\s*)?안\\s*(?:됨|된다|됩니다)(?![가-힣]))|만으로\\s[^.!?\\n]{0,40}?(?<![가-힣])순위를\\s*정하[^.!?\\n]{0,25}?(?:수\\s*없(?:다|습니다|음)(?![가-힣])|(?:해|하)서는\\s*안\\s*(?:됨|된다|됩니다)(?![가-힣]))|(?<![가-힣])순위[^.!?\\n]{0,20}?근거로\\s*(?:[*_]{1,2}\\s*)?사용할\\s*수\\s*(?:는\\s*)?없(?:다|습니다|음)(?![가-힣])|할\\s*수\\s*없는\\s*것\\s{0,3}:\\s{0,3}(?:[*_]{1,2}\\s{0,3})?[^.!?\\n]{0,30}?(?<![가-힣])순위를?\\s*매기거나|(?<![가-힣])표의\\s+(?:나열\\s+)?순서(?:는|가)\\s[^.!?\\n]{0,20}?(?<![가-힣])순위(?:(?:를|을)\\s*뜻하지\\s*(?:[*_]{1,2}\\s*)?않(?:음|는다|습니다)|(?:가|이)\\s*(?:[*_]{1,2}\\s*)?(?:아님|아니다|아닙니다)(?![가-힣]))",
       "flags": "m",
       "scope": "line",
       "context": [
         "fenced_code",
-        "quoted_user_text"
+        "quoted_user_text",
+        "blockquote_callout"
       ],
-      "rationale": "A line that tells the reader what the document, a table or a number is not for is a pledge to the reader, not a finding, so the write is refused and the pledge goes to the chat reply or turns into a data fact. The pattern recognises three shapes: a self-reference such as 이 표 or 본 자료 followed by a negated claim verb or a claim noun plus 아님; a claim noun such as 비교 or 순위 followed by (으)로 and a negated use verb, which has no subject at all; and a purpose-용 noun such as 공개용 수치 followed by 아님. Use verbs after a self-reference, 근거, 평가, 증거 and 추천 are deliberately absent, as are the legal and financial notice verbs 대체하, 보장하 and 권유, because operating rules, method lines and standard notices end that way.",
+      "rationale": "A line that tells the reader what the document, a table or a number is not for is a pledge to the reader, not a finding, so the write is refused and the pledge goes to the chat reply or turns into a data fact. The pattern recognises these shapes: a self-reference such as 이 표 or 본 자료 followed by a negated claim verb, a claim noun plus 아님 (순위표 also takes 아니고), or 위한/-려는 것이 아님; a claim noun such as 비교 or 순위 followed by 처럼/(으)로 and a negated use or reading verb, including 말아 주세요; a purpose-용 noun such as 공개용 수치 followed by 아님; 숫자 or 수치 said to be incomparable (서로 비교할 수 없다) or compared among themselves toward a quoted verdict; a speed judgment or a quoted verdict forbidden for these numbers; ranking refused for this data (…만으로 순위를 정할 수 없다, 할 수 없는 것: 순위를 매기거나); and a table's row order said not to be a ranking. Use verbs after a self-reference, 근거, 평가, 증거 and 추천 stay out, and so do inference limits (결론 내릴 수 없다), operating rules (…근거로 사용하지 마십시오), conditional method facts (…면 비교할 수 없다), type-system rules (숫자 문자열을 그대로 비교하지 마십시오), reported speech and explainers (…면 안 된다는 반론), order notices with no table anchor, and the legal and financial notice verbs 대체하, 보장하 and 권유, because operating rules, method lines, manuals and standard notices end that way. A quote line that opens with a bold label (> **주의:** …) is read as the author's own callout; any other quote line is skipped.",
       "fixture_ids": [
         "ko-negative-pledge:positive",
         "ko-negative-pledge:negative"
@@ -906,7 +907,8 @@
       "scope": "document",
       "context": [
         "fenced_code",
-        "quoted_user_text"
+        "quoted_user_text",
+        "blockquote_callout"
       ],
       "rationale": "Two sentences in one text that each end in 해석하지, 주장하지 or 대표하지 plus 않음, or in a claim noun plus 이/가 아님, turn a document into a list of disclaimers. The verbs 의미하, 간주하 and 인용하 and the use verbs stay out because repeated definitions, data-processing rules and operating rules end that way. A single such sentence is left to the warning-tier ko-status-negation.",
       "fixture_ids": [
@@ -918,14 +920,15 @@
       "id": "en-negative-pledge",
       "lang": "en",
       "severity": "block",
-      "pattern": "\\b(?:this|these)\\s+(?:deck|report|document|analysis|table|chart|figure|figures|numbers|results|slide|comparison)\\s+(?:(?:is|are)\\s+not\\s+(?:intended|meant|to\\s+be\\s+(?:read|used|taken|interpreted))(?:\\s+to\\s+be\\s+(?:read|used|taken|interpreted))?\\s+as\\b(?!\\s*(?:a\\s+substitute|a\\s+replacement|(?:legal|investment|medical|professional)\\s+advice))\\s+(?:an?\\s+|the\\s+)?(?:[A-Za-z0-9-]+\\s+){0,4}?(?:comparison|benchmark|ranking)s?\\b(?!-)(?!\\s+(?:arm|arms|group|groups|standard|standards|class|baseline)\\b)|(?:should|must)\\s+not\\s+be\\s+(?:read|used|taken|interpreted)\\s+as\\s+(?:an?\\s+|the\\s+)?(?:[A-Za-z0-9-]+\\s+){0,4}?(?:comparison|benchmark|ranking)s?\\b(?!-)(?!\\s+(?:arm|arms|group|groups|standard|standards|class|baseline)\\b)|makes?\\s+no\\s+claims?\\s+(?:about|that|regarding|as\\s+to)\\b)|\\b(?:this|these)\\s+(?:is|are)\\s+not\\s+(?:intended|meant)\\s+as\\b(?!\\s*(?:a\\s+substitute|a\\s+replacement|(?:legal|investment|medical|professional)\\s+advice))\\s+(?:an?\\s+|the\\s+)?(?:[A-Za-z0-9-]+\\s+){0,4}?(?:comparison|benchmark|ranking)s?\\b(?!-)(?!\\s+(?:arm|arms|group|groups|standard|standards|class|baseline)\\b)|\\bthe\\s+(?:deck|report|document|analysis)\\s+makes?\\s+no\\s+claims?\\s+(?:about|that|regarding|as\\s+to)\\b|(?:^|\\s[-*]\\s)\\s*(?:[-*]\\s+|\\d+\\.\\s+)?(?:[*_]{1,2})?not\\s+(?:intended|meant|to\\s+be\\s+read|to\\s+be\\s+used)\\s+as\\b(?!\\s*(?:a\\s+substitute|a\\s+replacement|(?:legal|investment|medical|professional)\\s+advice))\\s+(?:an?\\s+|the\\s+)?(?:[A-Za-z0-9-]+\\s+){0,4}?(?:comparison|benchmark|ranking)s?\\b(?!-)(?!\\s+(?:arm|arms|group|groups|standard|standards|class|baseline)\\b)|\\b(?:this|these)\\s+(?:table|chart|figure|figures|numbers|results|comparison|analysis)\\s+(?:does|do)\\s+not\\s+constitute\\s+(?:an?\\s+)?[^.!?]{0,60}?\\b(?:comparison|benchmark|ranking)s?\\b(?!-)(?!\\s+(?:arm|arms|group|groups|standard|standards|class|baseline)\\b)",
+      "pattern": "\\b(?:this|these)\\s+(?:deck|report|document|analysis|table|chart|figure|figures|numbers|results|slide|comparison)\\s+(?:(?:is|are)\\s+not\\s+(?:intended|meant|to\\s+be\\s+(?:read|used|taken|interpreted))(?:\\s+to\\s+be\\s+(?:read|used|taken|interpreted))?\\s+as\\b(?!\\s*(?:a\\s+substitute|a\\s+replacement|(?:legal|investment|medical|professional)\\s+advice))\\s+(?:an?\\s+|the\\s+)?(?:[A-Za-z0-9-]+\\s+){0,4}?(?:comparison|benchmark|ranking)s?\\b(?!-)(?!\\s+(?:arm|arms|group|groups|standard|standards|class|baseline)\\b)|(?:should|must)\\s+not\\s+be\\s+(?:read|used|taken|interpreted)\\s+as\\s+(?:an?\\s+|the\\s+)?(?:[A-Za-z0-9-]+\\s+){0,4}?(?:comparison|benchmark|ranking)s?\\b(?!-)(?!\\s+(?:arm|arms|group|groups|standard|standards|class|baseline)\\b)|makes?\\s+no\\s+claims?\\s+(?:about|that|regarding|as\\s+to)\\b)|\\b(?:this|these)\\s+(?:is|are)\\s+not\\s+(?:intended|meant)\\s+as\\b(?!\\s*(?:a\\s+substitute|a\\s+replacement|(?:legal|investment|medical|professional)\\s+advice))\\s+(?:an?\\s+|the\\s+)?(?:[A-Za-z0-9-]+\\s+){0,4}?(?:comparison|benchmark|ranking)s?\\b(?!-)(?!\\s+(?:arm|arms|group|groups|standard|standards|class|baseline)\\b)|\\bthe\\s+(?:deck|report|document|analysis)\\s+makes?\\s+no\\s+claims?\\s+(?:about|that|regarding|as\\s+to)\\b|(?:^|\\s[-*]\\s)\\s*(?:[-*]\\s+|\\d+\\.\\s+)?(?:[*_]{1,2})?not\\s+(?:intended|meant|to\\s+be\\s+read|to\\s+be\\s+used)\\s+as\\b(?!\\s*(?:a\\s+substitute|a\\s+replacement|(?:legal|investment|medical|professional)\\s+advice))\\s+(?:an?\\s+|the\\s+)?(?:[A-Za-z0-9-]+\\s+){0,4}?(?:comparison|benchmark|ranking)s?\\b(?!-)(?!\\s+(?:arm|arms|group|groups|standard|standards|class|baseline)\\b)|\\b(?:this|these)\\s+(?:table|chart|figure|figures|numbers|results|comparison|analysis)\\s+(?:does|do)\\s+not\\s+constitute\\s+(?:an?\\s+)?[^.!?]{0,60}?\\b(?:comparison|benchmark|ranking)s?\\b(?!-)(?!\\s+(?:arm|arms|group|groups|standard|standards|class|baseline)\\b)|\\bthey\\s+are\\s+not\\s+(?:an?\\s+)?(?:comparison|benchmark|ranking)s?\\b(?!-)(?!\\s+(?:arm|arms|group|groups|standard|standards|class|baseline)\\b)(?=\\s*(?:[.!?*_]|$))|\\b(?:do\\s+not|don[’']t)\\s+compare\\s+(?:these|those)\\s+(?:numbers|figures|results|values|scores|latencies)(?:\\s+(?:with|to)\\s+(?:each\\s+other|one\\s+another)\\b|(?=\\s*(?:[.!?*_]|$)))|\\b(?:these|those|the)\\s+(?:numbers|figures)\\s+are\\s+not\\s+comparable(?:\\s+(?:with|to)\\s+(?:each\\s+other|one\\s+another)\\b|(?=\\s*(?:[.!?*_]|$)))|\\b(?:this|the|these|our)\\s+(?:table|chart|figure|graph|list|report|document|deck|slide|page|summary|overview|analysis)s?\\s+(?:is|are)\\s+not\\s+(?:(?:meant|intended)\\s+)?(?:(?:to\\s+be\\s+)?(?:an?\\s+)?(?:ranking|benchmark|comparison|leaderboard|endorsement)s?\\b(?!-)(?!\\s+(?:arm|arms|group|groups|standard|standards|class|baseline)\\b)(?=\\s*(?:[.!?*_]|$))|to\\s+(?:rank|compare|benchmark)\\b)|\\b(?:do\\s+not|don[’']t)\\s+read\\s+(?:this|the|these|our)\\s+(?:table|chart|figure|graph|list|report|document|deck|slide|page|summary|overview|analysis)s?\\s+as\\s+(?:an?\\s+)?(?:comparison|benchmark|ranking)s?\\b(?!-)(?!\\s+(?:arm|arms|group|groups|standard|standards|class|baseline)\\b)",
       "flags": "i",
       "scope": "sentence",
       "context": [
         "fenced_code",
-        "quoted_user_text"
+        "quoted_user_text",
+        "blockquote_callout"
       ],
-      "rationale": "A sentence that says the deck, report, table or figures are not meant to be read as a comparison, benchmark, ranking or evaluation is a pledge to the reader, not a finding. The pattern needs a comparison noun, so the data-fact sentence about a sample that does not represent a population and investment-advice notices pass. A match followed by a substitute, replacement or professional advice is dropped, which keeps the standard legal notice. A sentence-initial 'Not to be read as' list item is covered too.",
+      "rationale": "A sentence that says the deck, report, table or figures are not meant to be read as a comparison, benchmark, ranking or evaluation is a pledge to the reader, not a finding. The pattern needs a comparison noun, so the data-fact sentence about a sample that does not represent a population and investment-advice notices pass. A match followed by a substitute, replacement or professional advice is dropped, which keeps the standard legal notice. A sentence-initial 'Not to be read as' list item is covered, and so are the short closers 'They are not a ranking.', 'Do not compare these numbers (with each other).' and 'The numbers are not comparable.', and a deliverable subject (this table, the report, our deck) that is not a ranking, is not meant to rank or compare, or is not to be read as a ranking. A refusal that continues into a description or an instruction (compare these values directly; …) is left alone, and a bare 'this' is not a subject. A bold-label quote callout is read as the author's own line.",
       "fixture_ids": [
         "en-negative-pledge:positive",
         "en-negative-pledge:negative"

package/assets/lithermes-plugin/skills/visual-qa/references/complete-contract.md

@@ -485,7 +485,7 @@ isolated Hermes home. Use `--hermes-home`; never `--home`.
 
 ```text
 $ node packages/lithermes-installer/bin/lithermes.js install --yes --offline --no-hud --hermes-home "$ISOLATED"
-Installed LitHermes 1.0.23
+Installed LitHermes 1.0.25
 plugin: $ISOLATED/plugins/lithermes
 model config: updated
 
@@ -502,7 +502,7 @@ installed payload: PASS
 enabled config: PASS
 
 $ hermes lithermes doctor
-[OK] plugin.yaml readable (version 1.0.23)
+[OK] plugin.yaml readable (version 1.0.25)
 [OK] skills bundled: 36
 [OK] litgoal durable runtime importable
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litfamily/lithermes",
-  "version": "1.0.23",
+  "version": "1.0.25",
   "description": "Hermes Agent plugin that plans, builds, checks and hands off your work when you add one word, lit, to a request.",
   "keywords": [
     "hermes-agent",

package/readme-assets/badge-version.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.23"><title>release: 1.0.23</title><g shape-rendering="crispEdges"><rect width="49" height="20" fill="#080d14"/><rect x="49" width="97" height="20" fill="#ff6337"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text x="255" y="140" textLength="390" transform="scale(.1)">release</text><text x="965" y="140" textLength="870" transform="scale(.1)" fill="#080D14">1.0.23</text></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.25"><title>release: 1.0.25</title><g shape-rendering="crispEdges"><rect width="49" height="20" fill="#080d14"/><rect x="49" width="97" height="20" fill="#ff6337"/></g><g fill="#fff" text-anchor="middle" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" text-rendering="geometricPrecision" font-size="110"><text x="255" y="140" textLength="390" transform="scale(.1)">release</text><text x="965" y="140" textLength="870" transform="scale(.1)" fill="#080D14">1.0.25</text></g></svg>

package/src/lib/check.js

@@ -6,6 +6,7 @@ const { detectHermesRuntimeRepo, detectHermesVersion, ensureHermesHome, expandHo
 const { formatManagedRoute } = require("./modelRoutePolicy");
 const { inspectPythonCache } = require("./files");
 const { assetRoot, pluginDest } = require("./install");
+const { autoUpdateDoctorLines } = require("./updateDoctor");
 const {
   formatSkillPayload,
   inspectSkillPayload,
@@ -311,6 +312,7 @@ function doctorLitHermes(flags = {}) {
     `cli payload dispatch: ${cli.ok ? formatDispatchStatus(cli) : "PATCH_AVAILABLE"}`,
     `tui payload dispatch: ${tui.ok ? formatDispatchStatus(tui) : "PATCH_AVAILABLE"}`,
     `gateway underscore dispatch: ${gateway.ok ? formatDispatchStatus(gateway) : "PATCH_AVAILABLE"}`,
+    ...autoUpdateDoctorLines(hermesHome),
     ...motionProbeLines(pluginPath, hermesHome),
   ];
 	return {

package/src/lib/modelRoutePolicy.js

@@ -30,6 +30,9 @@ const MODEL_ONLY_EFFORTS = {
   lead: new Map([[LEGACY_CHILD_MODEL, CHILD_EFFORT]]),
   child: new Map([[LEGACY_SOL_MODEL, "high"]]),
 };
+// Hermes's effort menu also offers `minimal`, which no OpenAI Responses model accepts;
+// Hermes sends it as `low` on every managed OpenAI route, so a saved `minimal` is judged as `low`.
+const HOST_SENT_EFFORTS = new Map([["minimal", "low"]]);
 const CHILD_TRANSPORT_KEYS = ["provider", "base_url", "api_mode"];
 const { OPENAI_PROVIDER: OPENAI_PROVIDER_ID } = require("./modelConfigBoundary");
 const XAI_PROVIDER_ID = "xai";
@@ -151,7 +154,7 @@ function inspectEffectiveRouteSafety(document, expectedProvider) {
   for (const route of managedRoutes) {
     if (transportReason && route.route === "global_child") continue;
     const modelEfforts = MODEL_EFFORTS.get(route.model);
-    if (modelEfforts && !modelEfforts.has(route.effort)) {
+    if (modelEfforts && !modelEfforts.has(HOST_SENT_EFFORTS.get(route.effort) ?? route.effort)) {
       const isAstra = route.model === ASTRA_MODEL;
       const isLuna = LUNA_MODELS.has(route.model);
       return {

package/src/lib/updateDoctor.js

@@ -0,0 +1,122 @@
+const fs = require("node:fs");
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+
+const PACKAGE_NAME = "@litfamily/lithermes";
+const BACKOFF_MS = 24 * 60 * 60 * 1000;
+const OPT_OUT_NAMES = ["LITHERMES_NO_AUTO_UPDATE", "NO_UPDATE_NOTIFIER", "LITHERMES_NO_UPDATE_CHECK", "CI"];
+
+// Doctor only reads these records; a link or a non-file is treated as absent.
+function readRecord(file) {
+  try {
+    if (!fs.lstatSync(file).isFile()) return null;
+    const value = JSON.parse(fs.readFileSync(file, "utf8"));
+    return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+  } catch {
+    return null;
+  }
+}
+
+function when(value) {
+  const ms = typeof value === "number" ? value : Date.parse(value);
+  return Number.isFinite(ms) ? `${new Date(ms).toISOString().slice(0, 16).replace("T", " ")} UTC` : "an unknown time";
+}
+
+function isAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error) {
+    return error.code === "EPERM";
+  }
+}
+
+function processStartedAt(pid) {
+  const result = spawnSync("ps", ["-o", "lstart=", "-p", String(pid)], { encoding: "utf8", env: { ...process.env, LC_ALL: "C" }, timeout: 5000 });
+  const ms = result.status === 0 ? Date.parse(result.stdout.trim()) : NaN;
+  return Number.isFinite(ms) ? ms : null;
+}
+
+function byHand(version) {
+  return `install it by hand: npx --yes --package ${PACKAGE_NAME}@${version} -- lithermes install --yes --no-hud`;
+}
+
+function attemptLines(attempt) {
+  if (!attempt) return [];
+  const target = attempt.latestVersion || "the latest release";
+  const at = when(attempt.at);
+  switch (attempt.reason) {
+    case "current":
+      return [`update: last check ${at}: up to date`];
+    case "updated":
+      return [`update: last check ${at}: updated ${attempt.currentVersion} to ${target}`];
+    case "update-check-failed":
+      return [`update: last check ${at}: could not reach the npm registry`, "update: remedy: check the network or proxy; the next Hermes CLI session checks again"];
+    case "automatic-install-failed":
+      return [`update: last check ${at}: npm could not install ${target}`, `update: remedy: check npm's registry and proxy settings, or ${byHand(target)}`];
+    case "automatic-install-timeout":
+      return [`update: last check ${at}: installing ${target} ran past 90 seconds and was stopped`, `update: remedy: ${byHand(target)}`];
+    case "backoff-after-failure":
+      return [
+        `update: last check ${at}: ${target} failed to install (${attempt.failedReason}), so the next try waits until ${when(Date.parse(attempt.failedAt) + BACKOFF_MS)}`,
+        `update: remedy: fix the cause above, or ${byHand(target)}`,
+      ];
+    default:
+      return attempt.status === "failed"
+        ? [`update: last check ${at}: installing ${target} did not finish cleanly (${attempt.reason}); the old version stayed`, `update: remedy: ${byHand(target)}, then run lithermes doctor`]
+        : [];
+  }
+}
+
+function receiptLines(receipt, installed) {
+  if (!receipt || receipt.status !== "failed") return [];
+  const target = receipt.targetVersion || "the new version";
+  if (receipt.state === "unknown" || receipt.rollback?.status === "failed") {
+    return [`update: the automatic update to ${target} could not restore the old files`, "update: remedy: keep the backup under lithermes/auto-update/ and get doctor --offline to pass before you start Hermes"];
+  }
+  const cause = receipt.doctor === "failed"
+    ? "failed its check after install"
+    : /timed out|interrupted/.test(String(receipt.reason)) ? "took longer than 30 seconds to install" : "did not install";
+  return [`update: ${target} ${cause} and was rolled back; you are still on ${installed} (${when(receipt.completedAt)})`, `update: remedy: run npx --yes --package ${PACKAGE_NAME}@${target} -- lithermes install --yes --no-hud yourself to see the error`];
+}
+
+function gatewayLines(hermesHome, installed, installedAtMs, probes) {
+  const record = readRecord(path.join(hermesHome, "gateway.pid"));
+  const pid = Number(record?.pid);
+  if (!record || record.kind !== "hermes-gateway" || !Number.isInteger(pid) || pid <= 0 || !probes.isAlive(pid)) return [];
+  const started = probes.processStartedAt(pid);
+  if (started === null || !Number.isFinite(installedAtMs)) return [`update: gateway pid ${pid} is running; doctor could not tell whether it started before ${installed} was installed`];
+  return started < installedAtMs
+    ? [`update: gateway pid ${pid} started before ${installed} was installed and still runs the older plugin; restart it: hermes gateway restart`]
+    : [`update: gateway pid ${pid} started after the install, so it loaded ${installed}`];
+}
+
+function autoUpdateDoctorLines(hermesHome, options = {}) {
+  const env = options.env || process.env;
+  const probes = { isAlive: options.isAlive || isAlive, processStartedAt: options.processStartedAt || processStartedAt };
+  const state = path.join(hermesHome, "lithermes");
+  const manifest = readRecord(path.join(state, "install-manifest.json"));
+  if (!manifest?.version) return ["update: no install record; run lithermes install"];
+  const installed = manifest.version;
+  const receipt = readRecord(path.join(state, "auto-update-receipt.json"));
+  const viaUpdate = receipt?.status === "updated" && receipt.targetVersion === installed;
+  const lines = [`update: installed ${installed} at ${when(manifest.installedAt)} by ${viaUpdate ? `an automatic update from ${receipt.currentVersion}` : "the installer"}`];
+  lines.push(...gatewayLines(hermesHome, installed, Date.parse(manifest.installedAt), probes));
+  lines.push(`update: a Hermes CLI, TUI or gateway started before then keeps the older plugin until restarted; doctor cannot see which version a running Hermes loaded`);
+  const optOut = OPT_OUT_NAMES.find((name) => Object.prototype.hasOwnProperty.call(env, name));
+  if (manifest.distribution !== "npm") {
+    lines.push("update: this copy was not installed by the npm installer, so it never updates itself; run lithermes install once to turn updates on");
+  } else if (optOut) {
+    lines.push(`update: automatic updates are off (${optOut} is set); install new versions yourself`);
+  } else {
+    lines.push("update: only the first message of a classic hermes CLI session, or lithermes install/check/doctor in a terminal, installs updates; the TUI and gateways never do");
+  }
+  const attempt = readRecord(path.join(state, "auto-update-attempt.json"));
+  const rolledBack = receiptLines(receipt, installed);
+  // A rolled-back transaction also makes the bridge exit non-zero; the receipt already names that cause.
+  const sameFailure = rolledBack.length && attempt?.reason === "automatic-install-failed" && attempt.latestVersion === receipt.targetVersion;
+  lines.push(...rolledBack, ...(sameFailure ? [] : attemptLines(attempt)));
+  return lines;
+}
+
+module.exports = { autoUpdateDoctorLines };