@litfamily/lithermes 1.0.27 → 1.0.29

package/README.md

@@ -1,14 +1,14 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.27/readme-assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.27/readme-assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: five armored robots power on one by one, the LitHermes robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.29/readme-assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.29/readme-assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: seven armored robots power on one by one, the LitHermes robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
 
 <p align="center">
-<a href="#install"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.27/readme-assets/badge-version.svg" alt="1.0.27" /></a>
-<a href="https://github.com/wjgoarxiv/lithermes/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.27/readme-assets/badge-license.svg" alt="MIT license" /></a>
+<a href="#install"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.29/readme-assets/badge-version.svg" alt="1.0.29" /></a>
+<a href="https://github.com/wjgoarxiv/lithermes/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.29/readme-assets/badge-license.svg" alt="MIT license" /></a>
 </p>
 
 <p align="center">
-<a href="https://github.com/wjgoarxiv/lithermes/blob/main/docs/guide.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.27/readme-assets/lucide-book-open.svg" width="16" alt="" /> Guide</a> &nbsp;
-<a href="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.27/readme-assets/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.27/readme-assets/lucide-play.svg" width="16" alt="" /> Ignition film</a> &nbsp;
-<a href="https://github.com/wjgoarxiv/lithermes/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.27/readme-assets/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
+<a href="https://github.com/wjgoarxiv/lithermes/blob/main/docs/guide.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.29/readme-assets/lucide-book-open.svg" width="16" alt="" /> Guide</a> &nbsp;
+<a href="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.29/readme-assets/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.29/readme-assets/lucide-play.svg" width="16" alt="" /> Ignition film</a> &nbsp;
+<a href="https://github.com/wjgoarxiv/lithermes/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.29/readme-assets/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
 </p>
 
 # LitHermes
@@ -17,7 +17,7 @@
 
 A plugin for **Hermes Agent**. Put `lit` in front of a request, and Hermes plans the task, does it, checks the result and writes down where things stand, so the next session can pick up where this one stopped.
 
-**[README and docs on GitHub](https://github.com/wjgoarxiv/lithermes#readme)** · [한국어](https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.27/README_Ko-KR.md)
+**[README and docs on GitHub](https://github.com/wjgoarxiv/lithermes#readme)** · [한국어](https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.29/README_Ko-KR.md)
 
 ## Install
 
@@ -46,7 +46,8 @@ The reply opens with a `🔥 **LIT IGNITED · <discipline>** 🔥` line once the
 | `lit <request>` or `/lit` | `litwork` | A task that ends with checked results |
 | `lit-plan` or `/lit-plan` | `lit-plan` | A plan, before anything is edited |
 | `/start-work <approved-plan>` | `start-work` | Running a plan you approved |
-| `lit review <target>` or `/review-work` | `review-work` | Reviewing a plan or a result |
+| `lit review [plan\|work] <target>` or `/review-work` | `review-work` | Reviewing a plan before `start-work`, or finished work after it |
+| `lit brainstorm <ask>` | `lit-brainstorm` | Many options for an open ask, then a short list to pick from |
 | `lit research <question>` | `litresearch` | Research with source notes |
 | `/lit-humanizer` | `lit-humanizer` | Revising Korean or English prose, meaning kept |
 | `/lit-diagram-drawer <brief>` | `lit-diagram-drawer` | A checked, editable diagram |
@@ -54,7 +55,7 @@ The reply opens with a `🔥 **LIT IGNITED · <discipline>** 🔥` line once the
 | `/lit-docx <brief>` | `lit-docx` | A restrained Word document in one of six named shapes, with its Markdown source |
 | `/lit-typographic-motion <brief>` | `lit-typographic-motion` | A short film, treatment first |
 
-On a Telegram gateway, use `/lit_loop` and `/lit_plan`. Every skill also loads by name as `lithermes:<name>`, for example `lithermes:lit-pptx` or `lithermes:lit-docx`. [Skills and commands](https://github.com/wjgoarxiv/lithermes/blob/main/docs/skills.md) shows all 36 with pictures.
+On a Telegram gateway, use `/lit_loop` and `/lit_plan`. Every skill also loads by name as `lithermes:<name>`, for example `lithermes:lit-pptx` or `lithermes:lit-docx`. [Skills and commands](https://github.com/wjgoarxiv/lithermes/blob/main/docs/skills.md) shows all 37 with pictures.
 
 ## Check, update, remove
 

package/README_Ko-KR.md

@@ -1,14 +1,14 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.27/readme-assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.27/readme-assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 다섯 로봇 패널이 차례로 켜지고, LitHermes 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.29/readme-assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.29/readme-assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 일곱 로봇 패널이 차례로 켜지고, LitHermes 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
 
 <p align="center">
-<a href="#설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.27/readme-assets/badge-version.svg" alt="1.0.27" /></a>
-<a href="https://github.com/wjgoarxiv/lithermes/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.27/readme-assets/badge-license.svg" alt="MIT license" /></a>
+<a href="#설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.29/readme-assets/badge-version.svg" alt="1.0.29" /></a>
+<a href="https://github.com/wjgoarxiv/lithermes/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.29/readme-assets/badge-license.svg" alt="MIT license" /></a>
 </p>
 
 <p align="center">
-<a href="https://github.com/wjgoarxiv/lithermes/blob/main/docs/guide.ko.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.27/readme-assets/lucide-book-open.svg" width="16" alt="" /> 안내</a> &nbsp;
-<a href="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.27/readme-assets/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.27/readme-assets/lucide-play.svg" width="16" alt="" /> Ignition 영상</a> &nbsp;
-<a href="https://github.com/wjgoarxiv/lithermes/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.27/readme-assets/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
+<a href="https://github.com/wjgoarxiv/lithermes/blob/main/docs/guide.ko.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.29/readme-assets/lucide-book-open.svg" width="16" alt="" /> 안내</a> &nbsp;
+<a href="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.29/readme-assets/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.29/readme-assets/lucide-play.svg" width="16" alt="" /> Ignition 영상</a> &nbsp;
+<a href="https://github.com/wjgoarxiv/lithermes/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.29/readme-assets/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
 </p>
 
 # LitHermes
@@ -17,7 +17,7 @@
 
 **Hermes Agent**용 플러그인입니다. 요청 앞에 `lit`을 붙이면 Hermes가 작업을 계획하고, 해내고, 결과를 확인한 뒤 어디까지 왔는지 적어 둡니다. 그래서 다음 세션이 그 기록을 읽고 멈춘 자리에서 이어 갈 수 있습니다.
 
-**[GitHub의 README와 문서](https://github.com/wjgoarxiv/lithermes/blob/main/README_Ko-KR.md)** · [English](https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.27/README.md)
+**[GitHub의 README와 문서](https://github.com/wjgoarxiv/lithermes/blob/main/README_Ko-KR.md)** · [English](https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.29/README.md)
 
 ## 설치
 
@@ -46,7 +46,8 @@ lit 외부 의존성 없이 HTML 파일 하나로 할 일 목록을 만들어줘
 | `lit <요청>` 또는 `/lit` | `litwork` | 범위를 정한 작업을 확인 결과까지 |
 | `lit-plan` 또는 `/lit-plan` | `lit-plan` | 아무것도 고치기 전에 계획부터 |
 | `/start-work <승인된 계획>` | `start-work` | 승인한 계획 실행 |
-| `lit review <대상>` 또는 `/review-work` | `review-work` | 계획이나 결과 검토 |
+| `lit review [plan\|work] <대상>` 또는 `/review-work` | `review-work` | `start-work` 전의 계획 검토, 또는 끝난 작업 검토 |
+| `lit brainstorm <요청>` | `lit-brainstorm` | 열린 요청에 대한 여러 선택지와, 고를 수 있는 짧은 목록 |
 | `lit research <질문>` | `litresearch` | 출처 메모가 있는 조사 |
 | `/lit-humanizer` | `lit-humanizer` | 의미를 지키며 한국어·영어 문장 다듬기 |
 | `/lit-diagram-drawer <brief>` | `lit-diagram-drawer` | 검사를 거친, 편집 가능한 다이어그램 |
@@ -54,7 +55,7 @@ lit 외부 의존성 없이 HTML 파일 하나로 할 일 목록을 만들어줘
 | `/lit-docx <brief>` | `lit-docx` | 여섯 가지 문서 형식 가운데 하나로 짠 절제된 Word 문서와 Markdown 원본 |
 | `/lit-typographic-motion <brief>` | `lit-typographic-motion` | 트리트먼트부터 쓰는 짧은 영상 |
 
-Telegram gateway에서는 `/lit_loop`와 `/lit_plan`을 쓰세요. 모든 스킬은 `lithermes:<이름>`으로도 불러올 수 있습니다. 예를 들어 `lithermes:lit-pptx`, `lithermes:lit-docx`처럼 씁니다. 스킬 36개 전체는 [스킬과 명령](https://github.com/wjgoarxiv/lithermes/blob/main/docs/skills.ko.md)에서 그림과 함께 볼 수 있습니다.
+Telegram gateway에서는 `/lit_loop`와 `/lit_plan`을 쓰세요. 모든 스킬은 `lithermes:<이름>`으로도 불러올 수 있습니다. 예를 들어 `lithermes:lit-pptx`, `lithermes:lit-docx`처럼 씁니다. 스킬 37개 전체는 [스킬과 명령](https://github.com/wjgoarxiv/lithermes/blob/main/docs/skills.ko.md)에서 그림과 함께 볼 수 있습니다.
 
 ## 확인, 업데이트, 삭제
 

package/assets/lithermes-plugin/README.md

@@ -81,7 +81,7 @@ CLI/plugin name, not the npm package name.
   `DEGRADED`; its exact first line, once and before any other reply content, is
   `🔥 **LIT IGNITED · lit-scientific-visualization** 🔥`.
 - `/lit-pptx <brief>` and `/lit-docx <brief>` load `lithermes:lit-pptx` and `lithermes:lit-docx`. Bare `lit` with report or slide authoring wording routes to the corresponding skill; a combined request creates both formats. The packaged `skills/lit-pptx/bin/office.mjs` installs pinned dependencies in the LitHermes cache on first use and exposes deck QA, integrity, DOCX conversion, editing, lint, and visual audit.
-- `/lit-typographic-motion <brief>` loads `lithermes:lit-typographic-motion`. Bare `lit` with a film-creation request writes a treatment first, then renders a stage film (a model-authored page captured frame by frame) or a type film on the installed WebGL2 engine. Pre-warm with `lithermes motion-runtime install`; check the five runtime probes with `lithermes motion-runtime status`. The render gate records measurements and withholds exports on flash failure. Typographic-motion engine adapted from mexicat/pdoom-video (MIT, Giacomo Magnanini), commit `ca251e3`.
+- `/lit-typographic-motion <brief>` loads `lithermes:lit-typographic-motion`. Bare `lit` with a film-creation request writes a treatment first, then renders a stage film (a model-authored page captured frame by frame) or a type film on the installed WebGL2 engine. A README, hero or banner loop takes cover mode (`$M cover`): a silent, seamless loop encoded as animated WebP and gated on the decoded file. Pre-warm with `lithermes motion-runtime install`; check the six runtime probes (the sixth is the cover encoder) with `lithermes motion-runtime status`. The render gate records measurements and withholds exports on flash failure. Typographic-motion engine adapted from mexicat/pdoom-video (MIT, Giacomo Magnanini), commit `ca251e3`.
 - `/lit-diagram-drawer <brief>` and the exact `lit-diagram-drawer` route load the
   installed diagram skill. Its Python checks cover source geometry, accessibility,
   content requirements, motion source rules, and visible-text findings; actual
@@ -96,6 +96,7 @@ CLI/plugin name, not the npm package name.
   `lit team` does not claim a literal native team mode.
   Intent-shaped skills route the same way from a bare leading token or after `lit`:
   `autoresearch`, `autoconference`, `wikify`, `lit-comprehend`, `refactor`, `debugging`, `lit-commit`,
+  `lit-brainstorm` (after `lit`: `brainstorm`, `brainstorming`, `ideation`, `ideate`, `idea`, `ideas`),
   `lit-burnoff`, `lit-burnoff-file`, `comment-checker`, `lsp`, `lsp-setup`, and
   `rules`.
 - On the first interactive top-level `pre_llm_call`, the payload runs one
@@ -172,7 +173,7 @@ CLI/plugin name, not the npm package name.
   keep the live-hit claim `UNPROVEN` until a real receipt arrives.
 - Explicit skills are available as:
   `lithermes:lit-burnoff-file`, `lithermes:autoresearch`, `lithermes:autoconference`,
-  `lithermes:lit-comprehend`,
+  `lithermes:lit-comprehend`, `lithermes:lit-brainstorm`,
   `lithermes:lit-humanizer`, `lithermes:comment-checker`,
   `lithermes:debugging`, `lithermes:deep-interview`,
   `lithermes:frontend-ui-ux`, `lithermes:readme-studio`, `lithermes:lit-commit`,
@@ -300,10 +301,14 @@ CLI/plugin name, not the npm package name.
   real status command from the installed plugin directory both succeed.
   The npm `doctor` surface also inspects generated bytecode without deleting it;
   package-payload cleanup belongs only to explicit test/pack preparation.
-- `/review-work` has a draft-plan mode and the existing completion mode. Plan
+- `/review-work` has two named modes: plan review (after `lit-plan`, before `start-work`) and
+  work review (after `lit-loop` or `start-work`). It auto-picks from what exists (a diff, changed
+  files outside `plans/` or ticked plan rows mean work; an unticked plan alone means plan; neither
+  means ask), `plan` or `work` after `lit review` or `/review-work` forces one, and the first report
+  line names the mode. Plan
   review audits scope/objective achievability, dependencies, atomic checklist
   items, acceptance/evidence, and failure/decision/cleanup, returning `PASS`,
-  `ITERATE`, or `NEEDS-CONTEXT` without implementation. Completion review remains
+  `ITERATE`, or `NEEDS-CONTEXT` without implementation. Work review remains
   the five-lane no-rubber-stamp gate: scope/diff, tests/evidence, package/payload,
   security/provenance, and real-surface/docs. A DoneClaim is blocked unless each
   falsifier has evidence and every generated or runtime artifact has a cleanup receipt.
@@ -350,12 +355,20 @@ npm --prefix packages/lithermes-installer run sync-plugin -- --in-place
   carries the static rules at 4,096 bytes and spills later hook results above
   10,000 characters). It names the ledger, the mode rules and the loop, and loads
   the `litwork` and `lit-code` skills through `skill_view` when they are needed.
+- Repeating `lit`: the first `lit` of a session sends the full activation above. While the
+  same discipline stays active, `lit ...` sends a note under 600 bytes (no skill reload, no new
+  run, plan file or goal). `lit <other discipline>` switches with that discipline's full
+  activation. A bare `lit` or `lit continue` continues whichever discipline is active, or with none
+  active resumes an unfinished start-work run or bounded work, and `lit new ...` or `lit restart ...` starts over. Only a bare `lit` with nothing active asks
+  what to start. The session record is in memory (`lit_reentry.py`); a missing, stale or
+  compacted record falls back to the full activation.
 - `lit plan`: planning-only. Do not implement or start work; create/refine a
   proportionate objective-achievable plan first. The route keeps the planning
   guard and plan path in view and loads `lithermes:lit-plan` through `skill_view`.
-- `lit review`: review-work audits a draft plan with `PASS` / `ITERATE` /
-  `NEEDS-CONTEXT`, or verifies completed work through the existing 5-lane
-  all-or-nothing gate. Review never implements the plan.
+- `lit review [plan|work]`: review-work audits a draft plan with `PASS` / `ITERATE` /
+  `NEEDS-CONTEXT` (plan review), or verifies completed work through the existing 5-lane
+  all-or-nothing gate (work review). The wrapper states `Review mode: plan|work (forced by the
+  user)` or the auto-pick rule. Review never implements the plan.
 - `lit research`: separate verified facts, hypotheses, sources, and uncertainty;
   journals live under `.hermes/lithermes/litresearch/<slug>/`. Public retrieval
   hardening tries public endpoint/feed routes first, records a structured
@@ -369,8 +382,14 @@ npm --prefix packages/lithermes-installer run sync-plugin -- --in-place
   `lit-scientific-visualization`, and `lit-diagram-drawer`: bounded bare or exact natural routes load the bundled
   skill body for the matching explicit skill; they do not fall back to generic
   Litwork.
-- `lit goal`: bind one objective plus checkable criteria in
-  `.hermes/lithermes/litgoal/`.
+- `lit goal`: litgoal sets and keeps the finish line; lit-loop and start-work run toward it.
+  Bind one objective plus checkable criteria in `.hermes/lithermes/litgoal/`.
+- `lit brainstorm` / `lit ideation` / `lit idea`: brainstorm-only. Diverge into many different
+  options, cluster, score against stated criteria, converge to a short list, ask the user to
+  pick or combine, then hand off to `deep-interview` (pick still vague) or `lit-plan` (pick
+  concrete). It never implements, creates no run or plan file, and keeps optional notes under
+  `.hermes/lithermes/brainstorm/<slug>/`. The route loads `lithermes:lit-brainstorm` through
+  `skill_view`.
 - `lit workflow` / `lit kanban`: durable-workflow setup/proposal mode through
   Hermes Kanban. Probe `hermes version`, `hermes kanban --help`, and
   `hermes profile list`; initialize/start gateway if missing; create/propose a

package/assets/lithermes-plugin/__init__.py

@@ -97,7 +97,7 @@ PORTED_SKILLS = [
     ),
     ("lit-pptx", "Create and inspect PowerPoint decks with the installed Office engine and QA gate."),
     ("lit-docx", "Create, edit, convert, and audit styled Word documents."),
-    ("lit-typographic-motion", "Direct an original film from a treatment: a drawn stage film or a type film, gated before delivery."),
+    ("lit-typographic-motion", "Direct an original film from a treatment, or a seamless README cover loop, gated before delivery."),
     (
         "readme-studio",
         "Write factual READMEs and compose local covers with outlined type, honest image capability and verified motion.",
@@ -106,6 +106,10 @@ PORTED_SKILLS = [
         "lit-commit",
         "Run the LitHermes git-history specialist for commits, rebases, blame, and bisect.",
     ),
+    (
+        "lit-brainstorm",
+        "Many options for an open ask, then a short list",
+    ),
     (
         "lit-crucible",
         "Stress-test a plan with Hermes-native delegate_task lanes before handing off to /lit-plan.",
@@ -132,7 +136,7 @@ PORTED_SKILLS = [
     ),
     (
         "review-work",
-        "Use when a patch, diff, branch or open changes need a defect or merge-readiness review with evidence per finding.",
+        "Use when a plan needs review before start-work, or finished work needs defect review with evidence per finding.",
     ),
     (
         "rules",
@@ -148,7 +152,7 @@ PORTED_SKILLS = [
     ),
     (
         "litgoal",
-        "Drive the LitHermes litgoal durable runtime (criteria, evidence, gates).",
+        "Sets and keeps the finish line that lit-loop and start-work run toward.",
     ),
     (
         "litwork",

package/assets/lithermes-plugin/auto_update.py

@@ -22,6 +22,7 @@ import calendar
 import json
 import os
 import re
+import shutil
 import stat
 import subprocess
 import sys
@@ -215,7 +216,11 @@ def sanitized_environment(home: Path | None = None, source: dict[str, str] | Non
     home = (home or resolve_hermes_home()).resolve()
     source = source if source is not None else dict(os.environ)
     safe: dict[str, str] = {}
-    for key in ("PATH", "HOME", "USERPROFILE", "TMPDIR", "TEMP", "TMP", "LANG", "LC_ALL", "LC_CTYPE", "TERM"):
+    # The Windows keys carry no secrets and npx cannot start without them.
+    for key in (
+        "PATH", "HOME", "USERPROFILE", "TMPDIR", "TEMP", "TMP", "LANG", "LC_ALL", "LC_CTYPE", "TERM",
+        "SYSTEMROOT", "WINDIR", "PATHEXT", "COMSPEC", "APPDATA", "LOCALAPPDATA",
+    ):
         value = source.get(key)
         if isinstance(value, str) and value:
             safe[key] = value
@@ -227,6 +232,14 @@ def sanitized_environment(home: Path | None = None, source: dict[str, str] | Non
     return safe
 
 
+def resolve_command(name: str, env: dict[str, str] | None = None, *, platform: str | None = None, which: Any = shutil.which) -> str:
+    """Return the launchable path of a PATH command; on Windows npx is npx.cmd and a bare name is not found."""
+
+    if (platform or sys.platform) != "win32":
+        return name
+    return which(name, path=(env or {}).get("PATH")) or name
+
+
 def _read_install_receipt(home: Path) -> dict[str, Any] | None:
     return _read_state_json(home, "auto-update-receipt.json")
 
@@ -357,8 +370,9 @@ def run_auto_update(*, kwargs: dict[str, Any] | None = None, env: dict[str, str]
     previous_failure = _recent_failure(home, latest)
     if previous_failure is not None:
         return outcome({"status": "skipped", "reason": "backoff-after-failure", "latestVersion": latest}, previous_failure)
+    install_env = sanitized_environment(home, environment)
     command = [
-        "npx",
+        resolve_command("npx", install_env),
         "--yes",
         "--package",
         f"{PACKAGE_NAME}@{latest}",
@@ -375,7 +389,7 @@ def run_auto_update(*, kwargs: dict[str, Any] | None = None, env: dict[str, str]
         result = runner(
             command,
             cwd=str(Path.cwd()),
-            env=sanitized_environment(home, environment),
+            env=install_env,
             stdin=subprocess.DEVNULL,
             stdout=subprocess.PIPE,
             stderr=subprocess.PIPE,

package/assets/lithermes-plugin/core.py

@@ -106,6 +106,11 @@ try:
 except (ImportError, ModuleNotFoundError):
     import deliverable_hedge_guard as _deliverable_hedges
 
+try:
+    from . import lit_reentry as _lit_reentry
+except (ImportError, ModuleNotFoundError):
+    import lit_reentry as _lit_reentry
+
 # Current-turn state stays in the compatibility facade because tests and the
 # plugin register surface intentionally inspect it directly.
 _PENDING_IGNITE: set[str] = set()
@@ -204,6 +209,7 @@ def on_session_start(**kwargs: Any) -> None:
     """
     release_browser_drive_state(kwargs.get("session_id"))
     _deliverable_hedges.release_session(kwargs.get("session_id"))
+    _lit_reentry.forget(kwargs.get("session_id"))
     _rules.begin_session(str(kwargs.get("session_id") or ""))
     _auto_handoff.begin_session(kwargs.get("session_id"))
     _print_agents_nudge(str(kwargs.get("platform") or ""))
@@ -261,6 +267,7 @@ def consume_rules_context(**kwargs: Any) -> str:
 def release_rules_session(session_id: Any) -> None:
     _rules.end_session(str(session_id or ""))
     _deliverable_hedges.release_session(session_id)
+    _lit_reentry.forget(session_id)
 
 def ignite(result: str | dict[str, str], route: str = "litwork") -> str | dict[str, str]:
     """Draw a command acknowledgement and require a separate model probe."""
@@ -1700,6 +1707,11 @@ def pre_llm_call(**kwargs: Any) -> dict[str, str] | None:
     route = detect_lit_mode(user_message)
     if route is None:
         return None
+    restart_rest = _lit_reentry.restart_rest(route.objective) if route.mode == "litwork" else None
+    if restart_rest is not None:
+        # `lit new ...` / `lit restart ...` drops the active mode and routes what follows it.
+        _lit_reentry.forget(session_id)
+        route = detect_lit_mode(f"lit {restart_rest}".strip()) or route
     _deliverable_hedges.activate_skill(session_id, route.mode)
 
     record_event(
@@ -1719,6 +1731,28 @@ def pre_llm_call(**kwargs: Any) -> dict[str, str] | None:
             _evict_pending_browser_state()
         return with_reader_contract(build_natural_mode_context(route), compact=True)
 
+    active = discipline(route.mode) if session_id else ""
+    compacted = _rules.compaction_stamp(kwargs.get("conversation_history"))
+    step = _lit_reentry.decide(
+        session_id,
+        active,
+        route.objective,
+        workspace=Path.cwd().resolve(),
+        compacted=compacted,
+        review_required=detect_review_modifier(user_message),
+    )
+    if step.kind != "first":
+        if step.discipline and session_id:
+            _PENDING_DISCIPLINE[session_id] = step.discipline
+        # The activation is already in this conversation; only a requested reader
+        # mode is request-scoped and has to ride along.
+        contract = (
+            reader_facing_contract_block(requested_reader_mode, authority="current_user_request", compact=True)
+            if requested_reader_mode is not None
+            else ""
+        )
+        return {"context": "\n\n".join(part for part in (step.note, contract) if part)}
+
     browser_report = None
     if route.mode == "browser-drive":
         # Measure once. The same structured report goes to the context and the guard.
@@ -1727,12 +1761,14 @@ def pre_llm_call(**kwargs: Any) -> dict[str, str] | None:
             arm_browser_drive_guard(session_id, browser_report)
     if route.mode == "lit-plan" and route.objective:
         planned = command_lit_plan(shlex.quote(route.objective))
+        _lit_reentry.remember(session_id, active, plan=planned["plan"], compacted=compacted)
         return with_reader_contract(
                 f"{build_natural_mode_context(route)}\n\n"
                 f"Durable plan: {planned['plan']}",
                 compact=True,
         )
     if route.mode != "litwork":
+        _lit_reentry.remember(session_id, active, compacted=compacted)
         if route.mode in _SKILL_ROUTE_CONTRACTS:
             compact_contract = reader_facing_contract_block(
                 requested_reader_mode,
@@ -1765,7 +1801,10 @@ def pre_llm_call(**kwargs: Any) -> dict[str, str] | None:
                 command="lit",
             )
             run_binding = build_run_binding(load_run_state(run_dir))
+            _lit_reentry.remember(session_id, active, run=str(run_dir), compacted=compacted)
     ui_handoff = litwork_ui_handoff(route.objective)
+    # A bare `lit` with nothing active asks what to start; every other activation is unchanged.
+    idle_note = f"\n\n{_lit_reentry.IDLE_NOTE}" if not run_binding and step.idle else ""
     if requested_reader_mode is None:
         if run_binding:
             return {
@@ -1774,8 +1813,8 @@ def pre_llm_call(**kwargs: Any) -> dict[str, str] | None:
                     f"{reader_facing_contract_block(compact=True)}"
                 )
             }
-        return {"context": LIT_CONTEXT + ui_handoff}
-    return with_reader_contract(build_litwork_context(run_binding) + ui_handoff)
+        return {"context": LIT_CONTEXT + ui_handoff + idle_note}
+    return with_reader_contract(build_litwork_context(run_binding) + ui_handoff + idle_note)
 
 
 def transform_llm_output(**kwargs: Any) -> str | None:

package/assets/lithermes-plugin/core_contexts.py

@@ -5,11 +5,13 @@ from pathlib import Path
 
 try:
     from .core_commands import build_korean_prose_cleanup_agent_message, build_lit_humanizer_agent_message
-    from .core_contract import LIT_CONTEXT, _skill_body_block, contract_route_block, skill_view_reference, installed_web_probe_command, installed_motion_cli, MOTION_FILM_CONTEXT, MOTION_SUBCOMMANDS
+    from .core_contract import LIT_CONTEXT, LITGOAL_MEANING, _skill_body_block, contract_route_block, skill_view_reference, installed_web_probe_command, installed_motion_cli, MOTION_FILM_CONTEXT, MOTION_SUBCOMMANDS
+    from .core_review import review_mode_line, review_target
     from .core_routing import NaturalLitRoute, detect_ui_mode, motion_cue
 except (ImportError, ModuleNotFoundError):
     from core_commands import build_korean_prose_cleanup_agent_message, build_lit_humanizer_agent_message
-    from core_contract import LIT_CONTEXT, _skill_body_block, contract_route_block, skill_view_reference, installed_web_probe_command, installed_motion_cli, MOTION_FILM_CONTEXT, MOTION_SUBCOMMANDS
+    from core_contract import LIT_CONTEXT, LITGOAL_MEANING, _skill_body_block, contract_route_block, skill_view_reference, installed_web_probe_command, installed_motion_cli, MOTION_FILM_CONTEXT, MOTION_SUBCOMMANDS
+    from core_review import review_mode_line, review_target
     from core_routing import NaturalLitRoute, detect_ui_mode, motion_cue
 
 # Intent-shaped skill routes: one wrapper each, same shape as the hand-written
@@ -453,6 +455,20 @@ def _build_natural_mode_context(
                 "</lithermes-natural-route>",
             ]
         )
+    if route.mode == "lit-brainstorm":
+        return "\n".join(
+            [
+                "<lithermes-natural-route mode=\"lit-brainstorm\">",
+                contract_route_block("lit-brainstorm", surface="natural-route", compact=True),
+                "Natural routing: standalone lit brainstorm, lit ideation or lit idea -> lithermes:lit-brainstorm.",
+                f"Open ask: {escape(objective, quote=True)}",
+                "Mode Contract: brainstorm-only. Diverge into many different options (quantity before judgment), cluster, score against stated criteria, converge to a short list with trade-offs, ask the user to pick or combine. Do not implement, write a plan, run start-work, or start a run.",
+                "Handoff: a still-vague pick goes to deep-interview, a concrete pick goes to lit-plan; end with READY FOR deep-interview, READY FOR lit-plan, or NOT READY.",
+                "Notes, only when the session spans turns: .hermes/lithermes/brainstorm/<slug>/notes.md. Ask in plain text, at most one blocking question.",
+                skill_view_reference("lit-brainstorm", "for the lenses, scoring matrix, and handoff rules"),
+                "</lithermes-natural-route>",
+            ]
+        )
     if route.mode == "lit-crucible":
         return "\n".join(
             [
@@ -479,12 +495,13 @@ def _build_natural_mode_context(
         return "\n".join(
             [
                 "<lithermes-natural-route mode=\"review-work\">",
-                contract_route_block("review-work", surface="natural-route"),
+                contract_route_block("review-work", surface="natural-route", compact=True),
                 "Natural routing: standalone lit review -> lithermes:review-work.",
-                f"Review target: {objective}",
-                "Mode Contract: verify only. Run the 5-lane review: goal/constraints, real-surface QA, code quality, security/safety, and context/docs/package readiness.",
-                "All lanes must pass; timeout, missing evidence, inconclusive output, or cleanup gaps block approval.",
-                _skill_body_block("review-work"),
+                review_mode_line(route.objective),
+                f"Review target: {review_target(route.objective) or objective}",
+                "Mode Contract: verify only. Plan review audits a draft plan before start-work; work review runs the 5-lane review: goal/constraints, real-surface QA, code quality, security/safety, and context/docs/package readiness.",
+                "Name the picked mode on the first line of the report. All work-review lanes must pass; timeout, missing evidence, inconclusive output, or cleanup gaps block approval.",
+                skill_view_reference("review-work", "for the plan review lanes, the five work-review lane prompts, and the verdict contracts"),
                 "</lithermes-natural-route>",
             ]
         )
@@ -526,12 +543,13 @@ def _build_natural_mode_context(
         return "\n".join(
             [
                 "<lithermes-natural-route mode=\"litgoal\">",
-                contract_route_block("litgoal", surface="natural-route"),
+                contract_route_block("litgoal", surface="natural-route", compact=True),
                 "Natural routing: standalone lit goal -> lithermes:litgoal.",
                 f"Objective: {objective}",
+                LITGOAL_MEANING,
                 "Mode Contract: bind one objective plus checkable criteria. Use goal_set with happy/edge/regression criteria before work proceeds.",
                 "Durable state: .hermes/lithermes/litgoal/ via goal_* tools or `hermes lithermes goal status`.",
-                _skill_body_block("litgoal"),
+                skill_view_reference("litgoal", "for the criteria, evidence, gate and steering procedure"),
                 "</lithermes-natural-route>",
             ]
         )

package/assets/lithermes-plugin/core_contract.py

@@ -36,7 +36,7 @@ def installed_web_probe_command() -> str:
     return f'node {shlex.quote(str(probe))} --url "$UI_URL" --out "$UIUX_EVIDENCE_DIR" --static "$PWD"'
 
 
-MOTION_SUBCOMMANDS = "stage|run|sound|look|gate|complete"
+MOTION_SUBCOMMANDS = "stage|cover|run|sound|look|gate|cover-gate|complete"
 # The neutral film context every motion surface shares. It states the path rule
 # without choosing a path; the skill and the treatment decide.
 MOTION_FILM_CONTEXT = (
@@ -45,7 +45,7 @@ MOTION_FILM_CONTEXT = (
     "quote video, a title sequence, or supplied words with no other subject) at 16:9; stage for "
     "every other film, and for any 9:16. Hand-encoded films are not the deliverable. Bare lit asks "
     "nothing; label every invention and a generated sound bed. View stills with vision_analyze; "
-    "done when $M complete exits 0."
+    "done when $M complete exits 0. A README cover loop takes cover mode (references/cover.md)."
 )
 
 
@@ -233,6 +233,11 @@ def _skill_body_block(name: str) -> str:
     return f"<lithermes-skill-body name=\"{name}\">\n{body}\n</lithermes-skill-body>"
 
 
+# The one-line meaning of litgoal. The skill, the route, the slash command and the
+# skill index all quote it, so the sentence is written once.
+LITGOAL_MEANING = "litgoal sets and keeps the finish line; lit-loop and start-work run toward it."
+
+
 def skill_view_reference(name: str, when: str) -> str:
     """Point a per-turn route at a registered skill instead of inlining its body.