@litfamily/litclaude 1.0.14 → 1.0.16

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 1.0.16 - 2026-09-30
+
+- The GitHub page (English and Korean) now has a short film about 25 seconds long under "Watch it in motion", and the README was rewritten again in plainer language.
+- The GitHub page shows what the optional Jev skill hint looks like on screen when it is on, off or unavailable. Jev stays off unless you turn it on.
+
+## 1.0.15 - 2026-09-29
+
+- `litclaude install` and updates no longer fail with an ownership conflict while Claude Code is using the plugin. Claude Code marks the version it has in use with an empty `.in_use` folder inside the version folder, and LitClaude now leaves that folder out of its ownership check. A file with that name still counts as a change LitClaude did not make.
+- README (English and Korean) and the npm install card: rewritten in plainer language, with the reason before the switches. The npm page stays a short install card that links to the full guide on GitHub.
+
 ## 1.0.14 - 2026-09-29
 
 - A global `npm install -g` now actually pre-warms the motion runtime. The runtime's `npm ci` inherited the global-install settings that npm gives the postinstall step, and npm refused it; those settings are now dropped for that call and for the office runtime's first-use install.

package/README.md

@@ -1,14 +1,14 @@
-<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.14/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.14/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: five armored robots power on one by one, the LitClaude 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/litclaude@1.0.16/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.16/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: five armored robots power on one by one, the LitClaude robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
 
 <h1 align="center">LitClaude</h1>
 <p align="center"><strong>Keep the work lit.</strong></p>
 <p align="center">Plan, build, and check your work in Claude Code. Leave the next session a place to begin.</p>
 <p align="center">
-  <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.14/docs/assets/readme/badge-version.svg" alt="1.0.14" />
-  <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.14/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.14/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
+  <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.16/docs/assets/readme/badge-version.svg" alt="1.0.16" />
+  <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.16/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.16/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
 </p>
 <p align="center">
-  <a href="https://github.com/wjgoarxiv/litclaude#readme">Full guide, skills gallery and A/B results on GitHub</a> · <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.14/README_ko-KR.md">한국어</a>
+  <a href="https://github.com/wjgoarxiv/litclaude#readme">Full guide, skills gallery and A/B results on GitHub</a> · <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.16/README_ko-KR.md">한국어</a>
 </p>
 
 LitClaude is a Claude Code plugin. Add `lit` to a request and Claude pins the goal, writes a
@@ -32,16 +32,21 @@ npm exec --yes --package @litfamily/litclaude@latest -- litclaude install --perm
 npm exec --yes --package @litfamily/litclaude@latest -- litclaude install --yolo
 ```
 
-`balanced` adds bounded read/search and routine Git, npm and Node rules; `yolo` adds broader
-edit/write patterns. LitClaude tracks the rules it inserted and removes only those.
+`balanced` allows limited reading and searching plus routine Git, npm and Node commands;
+`yolo` also allows broad edit and write patterns. LitClaude tracks the rules it inserted and
+removes only those.
 
-The install also uses the network: it pre-warms the motion runtime with `npm ci` for
-pinned engine packages and pinned, sha256-checked fonts. If that step fails, the install
-still succeeds and tells you what to run later. To skip it, set `LITCLAUDE_MOTION_PREWARM=0`
-and run `litclaude-ai motion-runtime install` when you want it. A global
-`npm install -g @litfamily/litclaude` runs the same setup from its postinstall hook; set
-`LITCLAUDE_AUTO_INSTALL=0` or `LITCLAUDE_POSTINSTALL_SKIP=1`, or pass `--ignore-scripts`, to
-skip that.
+The install downloads a little more than the plugin. The video skill needs a rendering
+engine and fonts and never downloads them mid-render, so the installer fetches them up
+front: `npm ci` for the pinned engine packages, and pinned fonts checked against their
+sha256. If that download fails, the install still finishes and tells you what to run later.
+
+- To put off just the video tools, set `LITCLAUDE_MOTION_PREWARM=0` and run
+  `litclaude-ai motion-runtime install` when you need them.
+- `npm install -g @litfamily/litclaude` runs this whole setup by itself, from its
+  postinstall hook. To switch that off, set `LITCLAUDE_AUTO_INSTALL=0` (or
+  `LITCLAUDE_POSTINSTALL_SKIP=1`), or add `--ignore-scripts`; then run `litclaude install`
+  yourself when you're ready.
 
 ## First steps
 
@@ -58,7 +63,7 @@ Build a to-do list in a single HTML file with no external dependencies.
 Implement add, complete, and delete. Record what you checked and the next step.
 ```
 
-Then open the file and try it yourself. A file that exists has not yet shown that it works.
+Then open the file and try the three actions yourself. That is how you find out it works.
 
 ## What people type
 
@@ -88,21 +93,24 @@ unclear briefs to `lit-diagram-drawer`, `lit-scientific-visualization`, `debuggi
   and a `5h [▏░] 4% ↻` rate-limit reset countdown.
 - Permission rules change only if you choose `--permission-mode balanced` or `--yolo`. An
   output style is written only if you pick one.
-- Work bound to a goal keeps its state in the project's `.litclaude/litgoal/`. Nothing keeps
-  running or resumes on its own after a session closes.
-
-The optional Jev skill hint is off by default. If you turn it on with `LITCLAUDE_JEV=1` and
-your own `TYPESAFE_API_KEY`, each eligible prompt goes to TypeSafe, truncated to 2,000
-characters with home paths, e-mail addresses and token-shaped strings redacted. Anything
-else in the prompt is sent as written, and TypeSafe bills your account. The agent's own
-tools can read the exported key too, so use a key kept for this feature with a low spend
-limit. Read the GitHub guide before you enable it.
+- Work bound to a goal keeps its state in the project's `.litclaude/litgoal/`. When a
+  session closes, everything stops; the next one starts when you open it.
+
+There is also an optional Jev skill hint, which can suggest a skill that fits your prompt.
+It is off by default, and turning it on sends your prompts off your machine. With `LITCLAUDE_JEV=1`
+and your own `TYPESAFE_API_KEY` set, each eligible prompt goes to TypeSafe, cut to 2,000
+characters, with home paths, e-mail addresses and token-shaped strings redacted. The rest
+of the prompt goes as written, and TypeSafe bills your account. The agent's own tools can
+read the exported key too, so give this feature a key of its own with a low spend limit.
+Read the GitHub guide before you enable it; it also shows what each state looks like on
+screen.
 
 ## Safety and uninstall
 
-Hooks read bounded Claude Code event JSON and do not execute your prompt text. Project-local
-LitClaude state is gitignored and never part of the npm package. To turn off automatic update
-checks, use `--no-auto-update`, `LITCLAUDE_NO_AUTO_UPDATE`, `NO_UPDATE_NOTIFIER` or
+The hooks read only the limited event data Claude Code passes them, and your prompt text is
+something to route, never something to run. LitClaude's state in your project is gitignored
+and never part of the npm package. Update checks run automatically; to turn them off, use
+`--no-auto-update`, `LITCLAUDE_NO_AUTO_UPDATE`, `NO_UPDATE_NOTIFIER` or
 `LITCLAUDE_NO_UPDATE_CHECK`.
 
 ```bash
@@ -111,13 +119,13 @@ npm exec --yes --package @litfamily/litclaude@latest -- litclaude uninstall
 ```
 
 `uninstall` removes only the plugin, HUD, permission and local state entries that LitClaude
-manages. It leaves unrelated Claude settings alone, and it refuses an installation that was
-modified or cannot be recognized.
+manages, and leaves the rest of your Claude settings in place. If an installation was
+changed by hand or doesn't look like one LitClaude made, it refuses to touch it.
 
 ## More
 
 - [Full guide, skills gallery and A/B results on GitHub](https://github.com/wjgoarxiv/litclaude#readme)
-- [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.14/docs/privacy.md)
-- [Migration and ownership conflicts](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.14/docs/migration.md)
-- [Release history](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.14/CHANGELOG.md)
-- [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.14/LICENSE)
+- [Privacy and network behavior](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.16/docs/privacy.md)
+- [Migration and ownership conflicts](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.16/docs/migration.md)
+- [Release history](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.16/CHANGELOG.md)
+- [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.16/LICENSE)

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/litclaude@1.0.14/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.14/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 다섯 로봇 패널이 차례로 켜지고, LitClaude 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.16/docs/assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.16/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 다섯 로봇 패널이 차례로 켜지고, LitClaude 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
 
 <h1 align="center">LitClaude</h1>
 <p align="center"><strong>Keep the work lit.</strong></p>
 <p align="center">Claude Code에서 계획하고, 만들고, 확인한 일을 다음 세션으로 이어가세요.</p>
 <p align="center">
-  <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.14/docs/assets/readme/badge-version.svg" alt="1.0.14" />
-  <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.14/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.14/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
+  <img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.16/docs/assets/readme/badge-version.svg" alt="1.0.16" />
+  <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.16/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.16/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
 </p>
 <p align="center">
-  <a href="https://github.com/wjgoarxiv/litclaude/blob/main/README_ko-KR.md">전체 안내, 스킬 갤러리, A/B 결과는 GitHub에서</a> · <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.14/README.md">English</a>
+  <a href="https://github.com/wjgoarxiv/litclaude/blob/main/README_ko-KR.md">전체 안내, 스킬 갤러리, A/B 결과는 GitHub에서</a> · <a href="https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.16/README.md">English</a>
 </p>
 
 LitClaude는 Claude Code 플러그인입니다. 요청 끝에 `lit`을 붙이면 Claude가 목표를 먼저
@@ -32,16 +32,20 @@ npm exec --yes --package @litfamily/litclaude@latest -- litclaude install --perm
 npm exec --yes --package @litfamily/litclaude@latest -- litclaude install --yolo
 ```
 
-`balanced`는 제한된 read/search와 routine Git, npm, Node rule을 더하고, `yolo`는 더 넓은
-edit/write pattern을 더합니다. LitClaude는 자신이 넣은 rule만 추적하고 그것만 지웁니다.
+`balanced`는 제한된 읽기·검색과 일상적인 Git, npm, Node 명령을 허용하고, `yolo`는 넓은
+편집·쓰기 패턴까지 허용합니다. LitClaude는 자신이 넣은 규칙만 기억해 두었다가 그것만 지웁니다.
 
-설치 중에는 네트워크도 씁니다. 고정된 engine package를 `npm ci`로 설치하고, 고정된
-font를 내려받아 sha256으로 확인해 motion runtime을 미리 준비합니다. 이 단계가 실패해도 설치는
-그대로 끝나고, 나중에 실행할 명령을 알려 줍니다. 건너뛰려면 `LITCLAUDE_MOTION_PREWARM=0`을
-설정하고, 필요할 때 `litclaude-ai motion-runtime install`을 실행하세요.
-`npm install -g @litfamily/litclaude`로 전역 설치하면 postinstall hook이 같은 설정을 실행합니다.
-이것까지 건너뛰려면 `LITCLAUDE_AUTO_INSTALL=0`이나 `LITCLAUDE_POSTINSTALL_SKIP=1`을 설정하거나
-`--ignore-scripts`를 붙이세요.
+설치할 때는 플러그인 말고도 조금 더 내려받습니다. 영상 만들기 스킬에는 렌더링 엔진과 글꼴이
+필요한데, 영상을 만드는 도중에는 이것을 내려받지 않기 때문에 미리 받아 둡니다. 버전을 고정한 엔진
+패키지를 `npm ci`로 설치하고, 고정된 글꼴을 내려받아 sha256으로 확인합니다. 이 준비가 실패해도
+설치는 끝나고, 나중에 실행할 명령을 알려 줍니다.
+
+- 영상 도구만 나중으로 미루려면 `LITCLAUDE_MOTION_PREWARM=0`을 설정하세요. 필요해지면
+  `litclaude-ai motion-runtime install`로 받으면 됩니다.
+- `npm install -g @litfamily/litclaude`로 전역 설치하면 설치 뒤에 도는 스크립트가 이 설정을
+  자동으로 실행합니다. 이것까지 끄려면 `LITCLAUDE_AUTO_INSTALL=0`(또는
+  `LITCLAUDE_POSTINSTALL_SKIP=1`)을 설정하거나 `--ignore-scripts`를 붙이고, 준비가 되면
+  `litclaude install`을 직접 실행하세요.
 
 ## 처음 해 볼 일
 
@@ -58,7 +62,7 @@ claude
 추가·완료·삭제 동작을 구현하고, 확인한 내용과 다음 행동을 남겨줘.
 ```
 
-끝나면 파일을 직접 열어 눌러 보세요. 파일이 생겼다고 동작까지 확인된 것은 아닙니다.
+끝나면 파일을 직접 열어 세 동작을 눌러 보세요. 제대로 작동하는지는 그렇게 해 봐야 압니다.
 
 ## 자주 쓰는 입력
 
@@ -83,38 +87,39 @@ LitClaude에는 직접 부르는 스킬 35개가 들어 있습니다. 모호한
 ## 설치 후 달라지는 것
 
 - Claude Code에 LitClaude 플러그인이 들어옵니다. 스킬, 명령, 에이전트, hook이 함께 들어옵니다.
-- 상태 줄에 LitClaude HUD가 나타납니다. `[🔥LITCLAUDE vX.Y.Z]`, `ctx [▎░░]` context bar,
-  `5h [▏░] 4% ↻` rate-limit 리셋 카운트다운을 보여 줍니다.
+- 상태 줄에 LitClaude HUD가 나타납니다. `[🔥LITCLAUDE vX.Y.Z]`, `ctx [▎░░]` 컨텍스트 막대,
+  `5h [▏░] 4% ↻` 사용 한도 리셋 카운트다운을 보여 줍니다.
 - 권한 규칙은 `--permission-mode balanced`나 `--yolo`를 고를 때만 바뀝니다. 출력 스타일도
   직접 고를 때만 기록합니다.
-- 목표를 연결한 작업은 프로젝트의 `.litclaude/litgoal/`에 상태를 남깁니다. 세션이 닫힌 뒤
-  계속 돌거나 저절로 재개되는 것은 없습니다.
+- 목표를 연결한 작업은 프로젝트의 `.litclaude/litgoal/`에 상태를 남깁니다. 세션을 닫으면 모든
+  것이 멈추고, 다음 세션은 직접 열어야 이어집니다.
 
-선택 기능인 Jev 스킬 힌트는 기본으로 꺼져 있습니다. `LITCLAUDE_JEV=1`과 본인의
-`TYPESAFE_API_KEY`로 켜면, 해당하는 프롬프트를 2,000자로 자르고 홈 경로, 이메일 주소,
-토큰 모양의 문자열을 가린 뒤 TypeSafe로 보냅니다. 그 밖의 내용은 적힌 그대로 전송되고,
-비용은 본인의 TypeSafe 계정에 청구됩니다. export한 키는 에이전트의 도구도 읽을 수 있으니,
-이 기능 전용 키를 만들고 사용 한도를 낮게 잡아 두세요. 켜기 전에 GitHub 안내를 먼저 읽어 주세요.
+프롬프트에 맞는 스킬을 추천해 주는 Jev 스킬 힌트도 있습니다. 선택 기능이라 기본으로 꺼져 있고,
+켜면 프롬프트가 컴퓨터 밖으로 나갑니다. `LITCLAUDE_JEV=1`과 본인의 `TYPESAFE_API_KEY`를
+설정하면, 해당하는 프롬프트를 2,000자로 자르고 홈 경로, 이메일 주소, 토큰 모양의 문자열을 가린
+뒤 TypeSafe로 보냅니다. 나머지는 적힌 그대로 가고, 비용은 본인의 TypeSafe 계정에 청구됩니다.
+셸에 넣어 둔 키는 에이전트의 도구도 읽을 수 있으니, 이 기능 전용 키를 만들고 사용 한도를 낮게
+잡아 두세요. 켜기 전에 GitHub 안내를 먼저 읽어 주세요. 각 상태가 화면에 어떻게 보이는지도 그 안내에 있습니다.
 
 ## 안전과 제거
 
-Hook은 제한된 Claude Code event JSON을 읽을 뿐, 입력한 prompt text를 실행하지 않습니다.
-프로젝트 로컬 LitClaude 상태는 gitignore되며 npm 패키지에 들어가지 않습니다. 자동 업데이트
-확인은 `--no-auto-update`, `LITCLAUDE_NO_AUTO_UPDATE`, `NO_UPDATE_NOTIFIER`,
-`LITCLAUDE_NO_UPDATE_CHECK`로 끌 수 있습니다.
+hook은 Claude Code가 넘겨 주는 제한된 이벤트 데이터만 읽고, 입력한 프롬프트는 작업 흐름을 고르는
+데 쓸 뿐 명령으로 실행하지 않습니다. 프로젝트 안에 생기는 LitClaude 상태는 gitignore되며 npm 패키지에
+들어가지 않습니다. 업데이트는 자동으로 확인하는데, 끄고 싶다면 `--no-auto-update`,
+`LITCLAUDE_NO_AUTO_UPDATE`, `NO_UPDATE_NOTIFIER`, `LITCLAUDE_NO_UPDATE_CHECK` 중 하나를 쓰세요.
 
 ```bash
 npm exec --yes --package @litfamily/litclaude@latest -- litclaude doctor
 npm exec --yes --package @litfamily/litclaude@latest -- litclaude uninstall
 ```
 
-`uninstall`은 LitClaude가 관리한 plugin, HUD, permission, local state만 지웁니다. 다른
-Claude 설정은 건드리지 않고, 수정되었거나 소유권을 확인할 수 없는 설치는 거절합니다.
+`uninstall`은 LitClaude가 관리하는 플러그인, HUD, 권한, 로컬 상태 항목만 지우고 나머지 Claude
+설정은 그대로 둡니다. 누가 손을 댔거나 LitClaude가 만든 것으로 알아볼 수 없는 설치는 거절합니다.
 
 ## 더 보기
 
 - [전체 안내, 스킬 갤러리, A/B 결과 (GitHub)](https://github.com/wjgoarxiv/litclaude/blob/main/README_ko-KR.md)
-- [개인정보와 네트워크](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.14/docs/privacy.md)
-- [이전 안내와 소유권 충돌](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.14/docs/migration.md)
-- [Release history](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.14/CHANGELOG.md)
-- [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.14/LICENSE)
+- [개인정보와 네트워크](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.16/docs/privacy.md)
+- [이전 안내와 소유권 충돌](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.16/docs/migration.md)
+- [Release history](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.16/CHANGELOG.md)
+- [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litclaude@1.0.16/LICENSE)

package/bin/install-ownership.mjs

@@ -5,6 +5,7 @@ import { compareStableSemver } from "./update-notifier.mjs";
 
 const stableVersion = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/u;
 const receiptName = ".litclaude-install-receipt.json";
+const hostUseMarker = ".in_use";
 // Exact pristine trees installed from the registry-published litclaude-ai@0.4.6 tarball.
 const legacyVersion = "0.4.6";
 const legacy046 = {
@@ -44,6 +45,7 @@ function treeHash(root) {
     for (const name of readdirSync(path).sort()) {
       if (!prefix && name === receiptName) continue;
       const next = join(path, name), rel = prefix ? `${prefix}/${name}` : name, value = lstatSync(next);
+      if (!prefix && name === hostUseMarker && value.isDirectory() && readdirSync(next).length === 0) continue;
       if (value.isDirectory()) { entries.push([rel, "directory"]); walk(next, rel); }
       else if (value.isFile() && value.nlink === 1) entries.push([rel, "file", createHash("sha256").update(readFileSync(next)).digest("hex")]);
       else conflict(next);

package/docs/assets/readme/badge-version.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.14"><title>release: 1.0.14</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.14</text></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.16"><title>release: 1.0.16</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.16</text></g></svg>

package/docs/hooks.md

@@ -262,7 +262,9 @@ through. The `.litclaude` and `.litclaude/jev` folders must be real folders too:
 is a symlink, the hint reads and writes nothing there, sends no request, and shows no hint or note. Because `TYPESAFE_API_KEY` is exported in the shell that starts Claude Code, the
 agent's own tools can read it too; use a key dedicated to this feature, with a low spend limit.
 `litclaude doctor` prints `Jev skill hint: off`, `Jev skill hint: on`,
-or `Jev skill hint: flag on but TYPESAFE_API_KEY missing`. The offline regression tests,
+or `Jev skill hint: flag on but TYPESAFE_API_KEY missing`. The GitHub README shows each
+visible state in sample output under
+[What you will see](https://github.com/wjgoarxiv/litclaude#what-you-will-see). The offline regression tests,
 which replace `fetch` in the real hook process, live in `test/jev-skill-hint.test.mjs`.
 
 ## Bounded-authority start-work lifecycle

package/docs/workflow-compatibility-audit.md

@@ -31,7 +31,7 @@ of the enumerated inventory and exact bytes. The report carries that snapshot's
 file count and deterministic SHA-256 digest. Success does not prove the mutable
 live tree remained clean after capture; a later tree state requires another run,
 while package and tarball guards independently bind their own exact payloads.
-Capture is bounded to 8 MiB per file and 32 MiB in aggregate, and the zero-entry
+Capture is bounded to 8 MiB per file and 48 MiB in aggregate, and the zero-entry
 allowlist is parsed from the captured bytes rather than a pre-capture pathname read.
 Legal companion paths, source paths, sizes, hashes, and aggregate are hard-pinned
 outside the generated manifest; the legal files are scanned normally and the package

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litfamily/litclaude",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "Claude Code-native workflow distribution.",
   "type": "module",
   "bin": {
@@ -57,7 +57,7 @@
     "postpack": "node tools/readme-for-npm.mjs restore",
     "check:npm-readme": "node tools/readme-for-npm.mjs check",
     "postinstall": "node scripts/postinstall.mjs",
-    "test": "node --test --test-concurrency=1 --import ./test/helpers/motion-offline-prewarm.mjs test/*.test.mjs",
+    "test": "node --test --test-concurrency=1 --import ./test/helpers/scrub-ambient-jev-env.mjs --import ./test/helpers/motion-offline-prewarm.mjs test/*.test.mjs",
     "validate:plugin": "node scripts/validate-plugin.mjs",
     "doctor": "node scripts/doctor.mjs",
     "qa:tmux": "bash scripts/qa-claude-plugin-smoke.sh",

package/plugins/litclaude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "litclaude",
   "description": "Claude Code-native workflow plugin with a bounded-authority start-work lifecycle.",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "author": {
     "name": "LitClaude contributors"
   },

package/plugins/litclaude/bin/litclaude-mcp.js

@@ -9,7 +9,7 @@ import {
 } from "../lib/wikify-knowledge.mjs";
 
 const protocolVersion = "2024-11-05";
-const serverVersion = "1.0.14";
+const serverVersion = "1.0.16";
 
 const publicSourceReadTool = {
   name: "public_source_read",