@litfamily/lithermes 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wjgoarxiv
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,186 @@
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.0/readme-assets/cover.webp" width="100%" alt="LitHermes v5 armory cover" /></p>
+
+```
+                             ▄▄▄▄
+                   ▗███▌   ▗██████▖
+ ▗▄▄▄▄▄          ▗▟████▌   ▝██████▘
+ ▐█████        ▗▟██████▌    ▝▀▜█▀▘
+ ▐█████      ▗▟███████▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
+ ▐█████    ▗▟█████████████████████████ ▐█▀
+ ▐█████    ████████████████████████████▀
+ ▐█████    ██▛▘   ▄ ▄▄▄▄▖▄▄▄▄▄▄▄▄▄▄▄▄▄▖
+ ▐█████    ▀    ▄██ ████▌█████████████▌
+ ▐█████       ▄████ ████▌█████████████▌
+ ▐█████     ▄█████▛                                 lithermes
+ ▐█████  ▗▟█████▀▘       ▄▄▄▄▄     ▗▖
+ ▐█████ ▐█████▀          █████     ▐▛▀
+ ▐█████ ▐███▀            █████
+ ▐█████ ▐█▀              █████
+ ▐█████ ▝                █████
+ ▐█████▄▄▄▄▄▄▄▖          █████
+ ▐███████████▛           █████
+ ▐██████████▀            █████
+
+```
+
+# LitHermes
+
+**Keep the work lit.**
+
+> **A spark has been placed in your hands.**
+> Give it a place in your work.
+
+A bug you want fixed. A screen you want built. A project you want to finish.
+Starting takes a sentence. Returning to the work takes a record: what you decided, what you checked, and what comes next.
+
+LitHermes connects planning, execution, review, and handoff inside **Hermes Agent**. It leaves goals, progress, and evidence with your project so the next session has somewhere to begin.
+
+**Leave something the next session can pick up.**
+
+[Start a small task](#first-use) · [Install](#quick-start) · [Choose your skin](#ignition-skin)
+
+[한국어](./README_Ko-KR.md) · [npm](https://www.npmjs.com/package/@litfamily/lithermes) · [GitHub](https://github.com/wjgoarxiv/lithermes)
+
+Source version: `@litfamily/lithermes@1.0.0`. Install the scoped package from npm with the command in Quick start. A reviewed local archive remains available as an optional isolated trial.
+
+Landing images load from the published package so they render on npmjs. Guide links still point at the source repository.
+
+## Start with one lit task
+
+Append `lit` to a prompt, or use `/lit`, to enter the Hermes plugin workflow. The plugin routes the request; Hermes Agent owns model execution.
+
+| Prompt or route | Effect |
+| --- | --- |
+| `lit` or `/lit` | Start a bounded task and leave checked results. |
+| `handoff` or `/lit-handoff` | Carry the current work and next step into another session. |
+| `lit-plan` | Write a plan before execution. |
+| `/start-work <approved-plan>` | Execute an approved plan. |
+| `/review-work` | Review a plan or result and record findings. |
+| `litresearch` | Use the shipped research workflow with source notes. |
+
+The route acknowledgement is a host message; it does not prove that the result or visual checks are complete.
+
+<p align="center"><a href="./docs/assets/readme/ignition-film.mp4"><img src="./docs/assets/readme/poster.png" width="720" alt="Ignition motion poster" /></a></p>
+
+The poster opens the optional film; this README keeps motion opt-in.
+
+## Practical routes and visual cues
+
+Use `lit` or `/lit` to start a bounded task, `handoff` or `/lit-handoff` to carry checked work
+forward, `lit-plan` to write criteria before execution, `/start-work <approved-plan>` to execute an
+approved plan, `/review-work` to inspect a plan or result, and `litresearch` to keep source notes.
+Each route leaves its expected effect in the project record; no new slash route is introduced here.
+Host limit: the Hermes plugin routes the request and Hermes Agent owns model execution, while host
+permissions, authentication, model access, and visual checks remain separate capabilities. A route
+acknowledgement or static editorial image is not completion evidence.
+
+<p align="center"><img src="../../docs/assets/lithermes-ignition-1600.webp" width="49%" alt="LitHermes ignition editorial cue" /> <img src="../../docs/assets/lithermes-continuity-1600.webp" width="49%" alt="LitHermes continuity editorial cue" /></p>
+
+## Quick start
+
+Have Hermes Agent and Node.js 18+ installed, with write access to your Hermes home (normally `~/.hermes`).
+
+The installer targets your Hermes home. For a separate trial, set `HERMES_HOME` to a new empty directory before installation and use that same value when starting Hermes. Keep your existing home and its settings. `--no-patch-installed-hermes` also prevents compatibility edits to the detected host installation outside that profile.
+
+The primary install uses the scoped package:
+
+```sh
+npx --yes --package @litfamily/lithermes@latest -- lithermes install --yes --no-style
+```
+
+For an optional isolated trial, use the reviewed local `.tgz` supplied with the release packet. Replace the example path, then run each line separately:
+
+```sh
+LITHERMES_PACK='/absolute/path/to/the-reviewed-package.tgz'
+```
+
+```sh
+npm exec --yes --package "$LITHERMES_PACK" -- lithermes install --yes --no-style --no-auto-update --no-patch-installed-hermes
+```
+
+The first `--yes` approves npx execution; the second approves Hermes configuration changes. `--no-style` skips the reply-writing style picker; it does not disable the native visual Skin. Installation does not connect to Telegram.
+
+## First use
+
+Restart the Hermes CLI or gateway, then enter this in the conversation:
+
+```text
+lit Build a to-do list in one HTML file without external dependencies. Implement add, complete, and delete; record what you checked and what remains.
+```
+
+For an explicit command, use `/lit <request>`. The reply begins with one `▲ LIT · <discipline>` line; the route acknowledgement appears when the reply arrives.
+
+## Continue the work
+
+```text
+Plan → Make → Check → Leave the next step
+```
+
+Open the HTML file yourself and try each action. Ask Hermes to separate checks it actually ran from anything still unverified. Then use `/lit-handoff` to leave the result and next action in the project. In a new session, open the same project and ask Hermes to read that handoff before continuing.
+
+The spark is the record you leave. It does not mean work runs forever after the session closes.
+
+## Ignition skin
+
+In the Hermes CLI, `/skin` lists the active and available skins. Select `/skin lithermes-ignition`, then restart Hermes to inspect the startup banner. Ignition uses orange, lime, ivory, and navy; its supported welcome includes the five-row MICRO mark even in the compact layout, while the host may still omit the full `banner_logo` there. The ten numbered accent presets are still available. A fresh interactive color-capable unattended install selects Ignition only when `display.skin` is absent. Existing selections and skin files are preserved.
+
+For a light terminal, select `/skin lithermes-tokyonight-day`; for a dark terminal, select `/skin lithermes-tokyonight`, then restart Hermes. Both keep body, status, and completion-menu text readable, recolor the existing MICRO and banner artwork, and preserve existing skin selections and files. Typed input keeps the terminal's default color. A natural Lit reply adds its MICRO acknowledgement once at the end.
+
+Existing named skin files are not auto-refreshed. To refresh an existing regular file, move it to a preserved backup, rerun the installer so the missing named file is recreated, then reapply your custom edits. Symlinked or unexpected targets remain protected. On macOS, the CPR-disabled `prompt_toolkit` divider may remain ANSI-256 even when other Rich output retains the approved colors.
+
+The Skin changes the CLI appearance. Output style changes the reply's wording. A gateway conversation does not show the CLI Skin. Rendered appearance depends on the host and terminal; installed YAML alone does not establish that it is visible.
+
+If Lit skills are missing, ask Hermes to call its `skills_list` tool and look for LitHermes entries. Plugin-provided skills and filesystem-only `/skills` listings may differ by host version. An import error in the Hermes log is a loading failure, not a missing pip package to install speculatively; retain the message and consult the operating guide.
+
+<details>
+<summary>Ignition artwork</summary>
+
+</details>
+
+## Core commands
+
+| Input | Use |
+|---|---|
+| `lit <request>` or `/lit` | Run a bounded task |
+| `lit plan <request>` or `/lit-plan` | Plan before execution |
+| `lit research <question>` | Research with evidence and uncertainty |
+| `lit review <target>` or `/review-work` | Review a plan or result |
+| `/start-work <approved-plan>` | Execute an already-approved plan |
+| `/lit-loop` | Start, inspect, resume, or close an explicit loop |
+| `/litgoal` | Track criteria, evidence, checkpoints, and blockers |
+| `/lit-handoff` | Write a verified continuation packet |
+| `/lit-korean` | Edit Korean prose while preserving meaning |
+
+For Telegram dispatch, use `/lit_loop` and `/lit_plan`. The [operating guide](https://github.com/wjgoarxiv/lithermes/blob/main/docs/guide.md) contains the full skill catalog and command examples.
+
+## Safety and host limits
+
+- Preview configuration changes with `npm exec --yes --package "$LITHERMES_PACK" -- lithermes install --dry-run --no-auto-update --no-patch-installed-hermes`. Code, quotations, and copied commands remain inert data; secrets are redacted before persistence or model handoff.
+- Native `/goal` is user-managed and unobserved. Durable `goal_*` state is authoritative; there is no automatic update, clear, or resume of native `/goal`.
+- Hermes uses a global child model route. Per-task model overrides and named reviewer routes are unavailable. A configuration receipt does not prove an effective child execution.
+- See the [operating and safety guide](https://github.com/wjgoarxiv/lithermes/blob/main/docs/guide.md) for approval boundaries, local records, Wikify capture opt-out, and model limits.
+
+## Verify and uninstall
+
+```sh
+npm exec --yes --package "$LITHERMES_PACK" -- lithermes doctor --offline --no-auto-update
+```
+
+```sh
+npm exec --yes --package "$LITHERMES_PACK" -- lithermes uninstall --yes --no-auto-update
+```
+
+If compatibility patches were installed, add `--rollback-patches` when uninstalling. Uninstall leaves native skin files and the selected `display.skin` in place. To clear the choice explicitly, run `npm exec --yes --package "$LITHERMES_PACK" -- lithermes hud off` in that profile; this keeps the skin files and other settings.
+
+## Deeper docs
+
+- [Operating guide: all commands, models, skins, and troubleshooting](https://github.com/wjgoarxiv/lithermes/blob/main/docs/guide.md)
+- [Python plugin contract](https://github.com/wjgoarxiv/lithermes/blob/main/packages/lithermes-installer/assets/lithermes-plugin/README.md)
+- [Changelog](https://github.com/wjgoarxiv/lithermes/blob/main/CHANGELOG.md)
+
+
+MIT License
+
+## Community and migration
+
+[Contributing](https://github.com/wjgoarxiv/lithermes/blob/main/CONTRIBUTING.md) · [Security](https://github.com/wjgoarxiv/lithermes/blob/main/SECURITY.md) · [Conduct](https://github.com/wjgoarxiv/lithermes/blob/main/CODE_OF_CONDUCT.md) · [Support](https://github.com/wjgoarxiv/lithermes/blob/main/SUPPORT.md) · [Privacy](https://github.com/wjgoarxiv/lithermes/blob/main/docs/privacy.md) · [Old package migration](https://github.com/wjgoarxiv/lithermes/blob/main/docs/migration.md)

package/README_Ko-KR.md

@@ -0,0 +1,188 @@
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/lithermes@1.0.0/readme-assets/cover.webp" width="100%" alt="LitHermes v5 armory cover" /></p>
+
+```
+                             ▄▄▄▄
+                   ▗███▌   ▗██████▖
+ ▗▄▄▄▄▄          ▗▟████▌   ▝██████▘
+ ▐█████        ▗▟██████▌    ▝▀▜█▀▘
+ ▐█████      ▗▟███████▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
+ ▐█████    ▗▟█████████████████████████ ▐█▀
+ ▐█████    ████████████████████████████▀
+ ▐█████    ██▛▘   ▄ ▄▄▄▄▖▄▄▄▄▄▄▄▄▄▄▄▄▄▖
+ ▐█████    ▀    ▄██ ████▌█████████████▌
+ ▐█████       ▄████ ████▌█████████████▌
+ ▐█████     ▄█████▛                                 lithermes
+ ▐█████  ▗▟█████▀▘       ▄▄▄▄▄     ▗▖
+ ▐█████ ▐█████▀          █████     ▐▛▀
+ ▐█████ ▐███▀            █████
+ ▐█████ ▐█▀              █████
+ ▐█████ ▝                █████
+ ▐█████▄▄▄▄▄▄▄▖          █████
+ ▐███████████▛           █████
+ ▐██████████▀            █████
+
+```
+
+# LitHermes
+
+**Keep the work lit.**
+
+> **불씨를 건네받았다.**<br>
+> **이제, 당신의 작업에 옮길 차례다.**
+
+고치고 싶은 버그 하나. 만들고 싶은 화면 하나. 끝내고 싶은 프로젝트 하나.
+
+시작은 짧은 한 줄이면 됩니다. 어려운 건 그다음입니다. 대화가 길어지고 세션이 바뀌면, 어디까지 했는지부터 다시 짚어야 합니다. 어떤 결정을 내렸는지, 무엇을 확인했는지, 다음에는 무엇을 해야 하는지.
+
+**LIT은 그 불씨를 남깁니다.**
+
+LitHermes는 **Hermes Agent**에서 계획, 실행, 검토, 인계를 이어갑니다. 목표와 계획, 확인한 결과, 다음에 할 일을 프로젝트에 기록합니다. 다음 세션에서 그 기록을 읽고 작업을 이어갈 수 있도록.
+
+**대화가 끝난 자리에서, 다음 작업이 시작되도록.**
+
+[작은 작업부터 시작](#첫-사용) · [설치](#빠른-시작) · [스킨 선택](#ignition-스킨)
+
+[English](./README.md) · [npm](https://www.npmjs.com/package/@litfamily/lithermes) · [GitHub](https://github.com/wjgoarxiv/lithermes)
+
+소스 기준 버전은 `@litfamily/lithermes@1.0.0`입니다. 빠른 시작의 명령으로 scoped package를 설치합니다. 별도 체험이 필요하면 검토된 로컬 압축 파일을 선택할 수 있습니다.
+
+랜딩 이미지는 게시된 패키지에서 불러와 npmjs에서도 보입니다. 안내 문서 링크는 소스 저장소를 가리킵니다.
+
+## 작은 lit 작업부터 시작하기
+
+프롬프트에 `lit`을 붙이거나 `/lit`을 입력하면 Hermes plugin 작업 흐름에 들어갑니다. plugin이 경로를 안내하고 실제 모델 실행은 Hermes Agent가 담당합니다.
+
+| 프롬프트 또는 경로 | 효과 |
+| --- | --- |
+| `lit` 또는 `/lit` | 확인할 기준이 있는 작은 작업을 시작합니다. |
+| `handoff` 또는 `/lit-handoff` | 현재 작업과 다음 할 일을 다음 세션으로 건넵니다. |
+| `lit-plan` | 실행 전에 계획을 작성합니다. |
+| `/start-work <승인된 계획>` | 승인한 계획을 실행합니다. |
+| `/review-work` | 계획이나 결과를 검토하고 발견 사항을 남깁니다. |
+| `litresearch` | 출처 메모를 남기는 제공된 조사 흐름을 사용합니다. |
+
+경로 확인 표시는 호스트 메시지이며 결과나 화면 확인이 끝났다는 증거는 아닙니다.
+
+<p align="center"><a href="./docs/assets/readme/ignition-film.mp4"><img src="./docs/assets/readme/poster.png" width="720" alt="Ignition 모션 포스터" /></a></p>
+
+포스터를 선택하면 선택형 영상을 엽니다. 이 README에서는 자동 재생하지 않습니다.
+
+## 실제 경로와 편집 이미지
+
+`lit` 또는 `/lit`은 범위를 정한 작업을 시작하고, `handoff` 또는 `/lit-handoff`는 확인한 작업을 다음
+세션으로 넘깁니다. `lit-plan`은 실행 전 기준을 작성하고, `/start-work <승인된 계획>`은 승인된 계획을
+실행하며, `/review-work`는 계획이나 결과를 검토하고, `litresearch`는 출처 메모를 남깁니다. 각 경로는
+프로젝트 기록에 기대한 효과를 남기며 새 슬래시 경로를 만들지 않습니다. 호스트 한계상 경로 안내는
+Hermes plugin이, 모델 실행은 Hermes Agent가 담당하지만 권한·인증·모델 접근·화면 확인은 별도 호스트
+능력입니다. 경로 확인이나 정적 편집 이미지는 완료 증거가 아닙니다.
+
+<p align="center"><img src="../../docs/assets/lithermes-ignition-1600.webp" width="49%" alt="LitHermes 시작 편집 이미지" /> <img src="../../docs/assets/lithermes-continuity-1600.webp" width="49%" alt="LitHermes 이어가기 편집 이미지" /></p>
+
+## 빠른 시작
+
+Hermes Agent와 Node.js 18+가 필요하며, Hermes 홈(기본 `~/.hermes`)에 쓰기 권한이 있어야 합니다.
+
+설치는 현재 Hermes 홈을 대상으로 합니다. 별도로 체험하려면 설치 전에 `HERMES_HOME`을 새 빈 디렉터리로 지정하고, Hermes를 시작할 때도 같은 값을 사용하세요. 기존 홈과 설정은 그대로 보관합니다. `--no-patch-installed-hermes`는 해당 프로필 밖에서 감지된 호스트 설치본에 호환성 패치를 쓰지 않도록 합니다.
+
+기본 설치는 scoped package를 사용합니다.
+
+```sh
+npx --yes --package @litfamily/lithermes@latest -- lithermes install --yes --no-style
+```
+
+별도 로컬 체험을 하려면 릴리스 안내와 함께 받은 검토된 `.tgz`를 선택할 수 있습니다. 예시 경로를 실제 파일 경로로 바꾸고, 각 줄을 따로 실행합니다.
+
+```sh
+LITHERMES_PACK='/absolute/path/to/the-reviewed-package.tgz'
+```
+
+```sh
+npm exec --yes --package "$LITHERMES_PACK" -- lithermes install --yes --no-style --no-auto-update --no-patch-installed-hermes
+```
+
+첫 `--yes`는 npx 실행을, 두 번째는 Hermes 설정 변경을 승인합니다. `--no-style`은 답변 문체 선택 질문만 생략합니다. 화면을 바꾸는 네이티브 Skin을 끄는 옵션은 아닙니다. 설치할 때 Telegram에 연결하지 않습니다.
+
+## 첫 사용
+
+Hermes CLI 또는 gateway를 다시 시작한 뒤 대화에 입력하세요.
+
+```text
+lit 외부 의존성 없이 HTML 파일 하나로 할 일 목록을 만들어줘. 추가·완료·삭제 동작을 구현하고, 확인한 내용과 다음 행동을 남겨줘.
+```
+
+명시적 명령은 `/lit <요청>`입니다. 응답은 `▲ LIT · <discipline>` 한 줄로 시작하며, 경로 확인 표시는 응답이 도착할 때 나타납니다.
+
+## 다음 작업으로 이어가기
+
+```text
+계획하기 → 만들기 → 확인하기 → 다음 작업에 건네기
+```
+
+완성한 HTML 파일을 직접 열어 각 동작을 확인하세요. Hermes에는 실제로 확인한 내용과 아직 확인하지 못한 내용을 나누어 남기도록 요청합니다. `/lit-handoff`로 결과와 다음 행동을 프로젝트에 기록한 뒤, 새 세션에서 같은 프로젝트를 열고 그 인계 문서를 먼저 읽도록 요청하세요.
+
+“꺼지지 않는 불”은 프로그램이 끝없이 돌아간다는 뜻이 아닙니다. **세션이 끝나도, 이어갈 작업을 남긴다는 뜻입니다.**
+
+## Ignition 스킨
+
+Hermes CLI에서 `/skin`으로 현재 스킨과 목록을 확인하세요. `/skin lithermes-ignition`을 선택하고, Hermes를 다시 시작해 시작 배너를 확인합니다. Ignition은 주황·라임·아이보리·네이비를 사용하며, 지원되는 시작 안내에는 컴팩트 레이아웃에서도 5행 MICRO 마크가 표시됩니다. 좁은 터미널에서는 호스트가 전체 `banner_logo`를 생략할 수 있습니다. 기존 번호 1~10의 색상 프리셋도 유지합니다. 색상을 지원하는 대화형 환경의 자동 승인 설치는 `display.skin`이 없을 때만 Ignition을 선택합니다. 기존 스킨 선택과 스킨 파일은 보존합니다.
+
+밝은 터미널에서는 `/skin lithermes-tokyonight-day`, 어두운 터미널에서는 `/skin lithermes-tokyonight`를 선택한 뒤 Hermes를 다시 시작하세요. 두 스킨은 본문·상태·completion 메뉴 글자를 읽기 쉽게 하고 기존 MICRO·배너 그림을 다시 칠하며, 기존 스킨 선택과 파일을 보존합니다. 입력한 텍스트는 터미널의 기본 글자색을 따릅니다. 자연스러운 Lit 응답에는 MICRO 안내가 끝에 한 번 붙습니다.
+
+이름이 있는 기존 스킨 파일은 자동으로 갱신하지 않습니다. 기존 일반 파일을 갱신하려면 먼저 보존용 백업으로 옮긴 뒤 설치기를 다시 실행해 빠진 이름의 파일을 새로 만들고, 사용자 수정 내용을 다시 적용하세요. 심볼릭 링크나 예상하지 못한 대상은 보호를 위해 교체하지 않습니다. macOS의 CPR 비활성 `prompt_toolkit` 구분선은 다른 Rich 출력이 승인된 색상을 유지해도 ANSI-256으로 남을 수 있습니다.
+
+Skin은 CLI 화면을, 출력 스타일은 답변 문체를 바꿉니다. Gateway 대화에는 CLI 스킨이 보이지 않습니다. 실제 모습은 호스트와 터미널에 따라 달라지므로 YAML 파일이 있다는 것만으로 적용을 확인할 수는 없습니다.
+
+Lit 스킬이 안 보이면 Hermes에 `skills_list` 도구를 호출해 LitHermes 항목을 확인하도록 요청하세요. 호스트 버전에 따라 플러그인 스킬과 파일시스템만 조회하는 `/skills` 목록이 다를 수 있습니다. 로그에 import 오류가 있으면 플러그인 로딩 실패입니다. 임의로 pip 패키지를 설치하지 말고 오류 메시지를 보관한 뒤 사용 안내를 확인하세요.
+
+<details>
+<summary>Ignition 아트워크</summary>
+
+</details>
+
+## 핵심 명령
+
+| 입력 | 용도 |
+|---|---|
+| `lit <요청>` 또는 `/lit` | 범위를 정한 작업 실행 |
+| `lit plan <요청>` 또는 `/lit-plan` | 실행 전 계획 작성 |
+| `lit research <질문>` | 근거와 불확실성을 기록하는 조사 |
+| `lit review <대상>` 또는 `/review-work` | 계획·결과 검토 |
+| `/start-work <승인된 계획>` | 이미 승인한 계획 실행 |
+| `/lit-loop` | 명시적 반복 작업의 시작·상태·재개·종료 |
+| `/litgoal` | 기준, 근거, 체크포인트와 막힌 지점 추적 |
+| `/lit-handoff` | 확인된 이어받기 문서 작성 |
+| `/lit-korean` | 의미를 유지하는 한국어 문장 다듬기 |
+
+Telegram gateway에서는 `/lit_loop`, `/lit_plan` 별칭을 사용합니다. 전체 스킬 목록과 명령 예시는 [사용 안내](https://github.com/wjgoarxiv/lithermes/blob/main/docs/guide.ko.md)에 있습니다.
+
+## 안전 모델
+
+- 설치 전 `npm exec --yes --package "$LITHERMES_PACK" -- lithermes install --dry-run --no-auto-update --no-patch-installed-hermes`으로 변경을 미리 확인할 수 있습니다. 코드·인용문·복사한 명령은 실행 지시로 취급하지 않으며, 비밀값은 저장·모델 전달 전에 가립니다.
+- native `/goal`은 사용자 관리 상태이며 플러그인이 관찰하거나 자동으로 갱신·초기화·재개하지 않습니다. 작업 상태의 기준은 durable `goal_*`입니다.
+- Hermes의 하위 에이전트는 공통 모델 경로를 사용합니다. 작업별 모델 재정의와 지정 reviewer 경로는 지원하지 않습니다. 설정 receipt만으로 실제 child 실행을 증명할 수는 없습니다.
+- 승인 경계, 로컬 기록, Wikify 수집 해제와 모델 제한은 [운영·안전 안내](https://github.com/wjgoarxiv/lithermes/blob/main/docs/guide.ko.md)를 확인하세요.
+
+## 확인 및 삭제
+
+```sh
+npm exec --yes --package "$LITHERMES_PACK" -- lithermes doctor --offline --no-auto-update
+```
+
+```sh
+npm exec --yes --package "$LITHERMES_PACK" -- lithermes uninstall --yes --no-auto-update
+```
+
+호환성 패치를 적용했다면 삭제 시 `--rollback-patches`를 추가하세요. 삭제 후에도 네이티브 스킨 파일과 `display.skin` 선택은 남습니다. 선택을 지우려면 해당 프로필에서 `npm exec --yes --package "$LITHERMES_PACK" -- lithermes hud off`를 실행하세요. 스킨 파일과 다른 설정은 유지합니다.
+
+## 더 읽을 문서
+
+- [사용 안내: 전체 명령, 모델, 스킨, 문제 해결](https://github.com/wjgoarxiv/lithermes/blob/main/docs/guide.ko.md)
+- [Python 플러그인 계약](https://github.com/wjgoarxiv/lithermes/blob/main/packages/lithermes-installer/assets/lithermes-plugin/README.md)
+- [변경 기록](https://github.com/wjgoarxiv/lithermes/blob/main/CHANGELOG.md)
+
+
+MIT License
+
+## Community and migration
+
+[Contributing](https://github.com/wjgoarxiv/lithermes/blob/main/CONTRIBUTING.md) · [Security](https://github.com/wjgoarxiv/lithermes/blob/main/SECURITY.md) · [Conduct](https://github.com/wjgoarxiv/lithermes/blob/main/CODE_OF_CONDUCT.md) · [Support](https://github.com/wjgoarxiv/lithermes/blob/main/SUPPORT.md) · [Privacy](https://github.com/wjgoarxiv/lithermes/blob/main/docs/privacy.md) · [Old package migration](https://github.com/wjgoarxiv/lithermes/blob/main/docs/migration.md)

package/assets/lithermes-plugin/NOTICE.md

@@ -0,0 +1,46 @@
+# Notice
+
+This plugin is a Hermes-native adaptation of the bundled workflow reference:
+
+- Repository: bundled workflow reference
+- Reference commit inspected for this port:
+  `3fb8802e314dc0a1f23481dd3782cdca26b92dc2`
+
+The runtime implementation here is not a vendored upstream runtime. LitHermes
+re-implements command dispatch against Hermes' plugin, hook, skill, and LSP
+surfaces.
+
+## TokyoNight palette attribution
+
+The `lithermes-tokyonight-day` and `lithermes-tokyonight` palette values are
+derived from [`folke/tokyonight.nvim`](https://github.com/folke/tokyonight.nvim/tree/cdc07ac78467a233fd62c493de29a17e0cf2b2b6)
+at commit `cdc07ac78467a233fd62c493de29a17e0cf2b2b6`; no upstream code is
+copied. The upstream palette source carries an Apache-2.0 `LICENSE`; generated
+Kitty palette headers carry a separate MIT notice. Those notices are distinct
+from the LitHermes package license.
+
+The bundled skill markdown is adapted from MIT-licensed workflow guidance, with
+Hermes-specific command mapping for `/lit`,
+`/lit-loop`, `/lit-plan`, `/lit_loop`, and `/lit_plan`.
+
+## MIT License Notice
+
+Copyright (c) 2026 Yeongyu Kim
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.