@litfamily/litgrok 1.0.27 → 1.0.28

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,20 +1,20 @@
1
- <p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/assets/cover-motion-still.webp" /><source media="(prefers-reduced-motion: no-preference)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/assets/cover-motion.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: seven armored robots power on one by one, the LitGrok robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
1
+ <p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/assets/cover-motion-still.webp" /><source media="(prefers-reduced-motion: no-preference)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/assets/cover-motion.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: seven armored robots power on one by one, the LitGrok robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
2
2
 
3
3
  <h1 align="center">LitGrok</h1>
4
4
  <p align="center"><strong>Keep the work lit.</strong></p>
5
5
 
6
6
  LitGrok gives xAI's Grok Build the habit of planning before it edits, checking what it built, and leaving a handoff, so tomorrow's session starts where today's stopped. One npm command adds its skills, project rule and hooks to your project.
7
7
 
8
- **[Full README on GitHub](https://github.com/wjgoarxiv/litgrok#readme)** · [Guide](https://github.com/wjgoarxiv/litgrok/blob/main/docs/guide.md) · [All skills](https://github.com/wjgoarxiv/litgrok/blob/main/docs/skills.md) · [한국어](https://github.com/wjgoarxiv/litgrok/blob/main/README_ko-KR.md) · [Install](#install-in-30-seconds) · [Reference](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/reference.md)
8
+ **[Full README on GitHub](https://github.com/wjgoarxiv/litgrok#readme)** · [Guide](https://github.com/wjgoarxiv/litgrok/blob/main/docs/guide.md) · [All skills](https://github.com/wjgoarxiv/litgrok/blob/main/docs/skills.md) · [한국어](https://github.com/wjgoarxiv/litgrok/blob/main/README_ko-KR.md) · [Install](#install-in-30-seconds) · [Reference](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/reference.md)
9
9
 
10
10
  <p align="center">
11
- <a href="#install-in-30-seconds"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/assets/readme/badge-version.svg" alt="1.0.27" /></a>
12
- <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
11
+ <a href="#install-in-30-seconds"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/assets/readme/badge-version.svg" alt="1.0.28" /></a>
12
+ <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/assets/readme/badge-license.svg" alt="MIT license" /></a>
13
13
  </p>
14
14
 
15
- <p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/reference.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/assets/readme/lucide-book-open.svg" width="16" alt="" /> Docs</a> &nbsp; <a href="#install-in-30-seconds">Install</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/assets/cover-motion.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/assets/readme/lucide-play.svg" width="16" alt="" /> Cover motion</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/assets/readme/lucide-shield-check.svg" width="16" alt="" /> MIT</a></p>
15
+ <p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/reference.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/assets/readme/lucide-book-open.svg" width="16" alt="" /> Docs</a> &nbsp; <a href="#install-in-30-seconds">Install</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/assets/cover-motion.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/assets/readme/lucide-play.svg" width="16" alt="" /> Cover motion</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/assets/readme/lucide-shield-check.svg" width="16" alt="" /> MIT</a></p>
16
16
 
17
- Long Grok Build sessions get compacted, a new session starts without what the last one knew, and "done" often just means the model said so. LitGrok gives each session a routine to follow: a written plan before the first edit, checks against that plan, and a handoff file the next session can read. It ships 42 skills, 11 agents, one project rule, and eleven hook registrations. Grok Build still runs the session and chooses the model. It suits work that runs longer than one sitting, such as a feature spread over a few days or a report someone else will read.
17
+ Long Grok Build sessions get compacted, a new session starts without what the last one knew, and "done" often just means the model said so. LitGrok gives each session a routine to follow: a written plan before the first edit, checks against that plan, and a handoff file the next session can read. It ships 42 skills, 11 agents, one project rule, and twelve hook registrations. Grok Build still runs the session and chooses the model. It suits work that runs longer than one sitting, such as a feature spread over a few days or a report someone else will read.
18
18
 
19
19
  ## Install in 30 seconds
20
20
 
@@ -24,7 +24,7 @@ You need Node.js and Grok Build. In an interactive terminal, from the project yo
24
24
  npm exec --yes --package @litfamily/litgrok@latest -- litgrok install
25
25
  ```
26
26
 
27
- The files land in `<project>/.grok/`. Add `--user` to install under `~/.grok/` instead, or use `--package @litfamily/litgrok@1.0.27` to pin this release. Add `--dry-run` to see every destination before anything is written.
27
+ The files land in `<project>/.grok/`. Add `--user` to install under `~/.grok/` instead, or use `--package @litfamily/litgrok@1.0.28` to pin this release. Add `--dry-run` to see every destination before anything is written.
28
28
 
29
29
  Trying a local package instead? Put its real absolute path in a variable, then run these two lines separately:
30
30
 
@@ -73,7 +73,7 @@ Beyond code, `lit-pptx` makes slide decks and `lit-docx` makes reports and Word
73
73
 
74
74
  ## What changes after install
75
75
 
76
- The installer copies the skills, agents, project rule, and hooks into `.grok/`. The eleven hook registrations in [`hooks/hooks.json`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/hooks/hooks.json) run only in a trusted Git root, and they log the order of events in `.grok/litgrok/session-ledger/`. Everything runs inside your Grok session, and nothing runs in the background; when the session ends, the work waits for the next one.
76
+ The installer copies the skills, agents, project rule, and hooks into `.grok/`. The twelve hook registrations in [`hooks/hooks.json`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/hooks/hooks.json) run only in a trusted Git root, and they log the order of events in `.grok/litgrok/session-ledger/`. Everything runs inside your Grok session, and nothing runs in the background; when the session ends, the work waits for the next one.
77
77
 
78
78
  If you'd like a status row showing the active LitGrok skill, the model and how much context is used, add it with `install --user --status-line`. It writes `[ui.status_line]` into `~/.grok/config.toml` and backs up an existing file first. Once a prompt starts a workflow skill, the row also shows the workflow stage, the tool running now and the last test result. Add `--notify` for Grok's terminal notification when a turn finishes.
79
79
 
@@ -112,6 +112,6 @@ If the status row is missing, add it with `install --user --status-line`. Grok r
112
112
 
113
113
  If LitGrok saves you some re-explaining, a [star on GitHub](https://github.com/wjgoarxiv/litgrok) helps other Grok Build users find it.
114
114
 
115
- [Reference](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/reference.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/CHANGELOG.md) · [Privacy](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/privacy.md) · [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/LICENSE)
115
+ [Reference](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/reference.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/CHANGELOG.md) · [Privacy](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/privacy.md) · [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/LICENSE) · [Trademark policy](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/TRADEMARK.md)
116
116
 
117
117
  The cover is brand motion made with the LitFamily motion skill: animated artwork, with no Grok session recorded in it.
package/README_ko-KR.md CHANGED
@@ -1,20 +1,20 @@
1
- <p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/assets/cover-motion-still.webp" /><source media="(prefers-reduced-motion: no-preference)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/assets/cover-motion.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 일곱 로봇 패널이 차례로 켜지고, LitGrok 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
1
+ <p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/assets/cover-motion-still.webp" /><source media="(prefers-reduced-motion: no-preference)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/assets/cover-motion.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 일곱 로봇 패널이 차례로 켜지고, LitGrok 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
2
2
 
3
3
  <h1 align="center">LitGrok</h1>
4
4
  <p align="center"><strong>Keep the work lit.</strong></p>
5
5
 
6
6
  LitGrok은 xAI Grok Build가 코드를 고치기 전에 계획부터 세우고, 만든 결과를 확인하고, 인수인계 문서를 남기게 합니다. 그러면 내일 세션이 오늘 멈춘 자리에서 이어집니다. npm 명령 한 줄이면 스킬과 프로젝트 규칙, 훅이 프로젝트에 들어갑니다.
7
7
 
8
- **[GitHub에서 README 전체 보기](https://github.com/wjgoarxiv/litgrok/blob/main/README_ko-KR.md)** · [안내서](https://github.com/wjgoarxiv/litgrok/blob/main/docs/guide_ko-KR.md) · [전체 스킬](https://github.com/wjgoarxiv/litgrok/blob/main/docs/skills_ko-KR.md) · [English](https://github.com/wjgoarxiv/litgrok#readme) · [설치](#30초-설치) · [상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/reference_ko-KR.md)
8
+ **[GitHub에서 README 전체 보기](https://github.com/wjgoarxiv/litgrok/blob/main/README_ko-KR.md)** · [안내서](https://github.com/wjgoarxiv/litgrok/blob/main/docs/guide_ko-KR.md) · [전체 스킬](https://github.com/wjgoarxiv/litgrok/blob/main/docs/skills_ko-KR.md) · [English](https://github.com/wjgoarxiv/litgrok#readme) · [설치](#30초-설치) · [상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/reference_ko-KR.md)
9
9
 
10
10
  <p align="center">
11
- <a href="#30초-설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/assets/readme/badge-version.svg" alt="1.0.27" /></a>
12
- <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/assets/readme/badge-license.svg" alt="MIT 라이선스" /></a>
11
+ <a href="#30초-설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/assets/readme/badge-version.svg" alt="1.0.28" /></a>
12
+ <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/assets/readme/badge-license.svg" alt="MIT 라이선스" /></a>
13
13
  </p>
14
14
 
15
- <p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/reference_ko-KR.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/assets/readme/lucide-book-open.svg" width="16" alt="" /> 상세 안내</a> &nbsp; <a href="#30초-설치">설치</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/assets/cover-motion.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/assets/readme/lucide-play.svg" width="16" alt="" /> 커버 모션</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/assets/readme/lucide-shield-check.svg" width="16" alt="" /> MIT</a></p>
15
+ <p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/reference_ko-KR.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/assets/readme/lucide-book-open.svg" width="16" alt="" /> 상세 안내</a> &nbsp; <a href="#30초-설치">설치</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/assets/cover-motion.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/assets/readme/lucide-play.svg" width="16" alt="" /> 커버 모션</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/assets/readme/lucide-shield-check.svg" width="16" alt="" /> MIT</a></p>
16
16
 
17
- Grok Build 세션이 길어지면 대화가 압축되고, 새 세션은 앞 세션이 알던 내용을 모른 채 시작하며, "다 됐다"는 말도 모델이 그렇게 말했다는 뜻일 때가 많습니다. LitGrok은 세션마다 따라갈 순서를 줍니다. 첫 수정 전에 계획을 글로 남기고, 그 계획에 비추어 확인하고, 다음 세션이 읽을 인수인계 문서를 남깁니다. 스킬 42개, 에이전트 11개, 프로젝트 규칙 하나, 훅 등록 열한 개가 들어 있고, 세션 실행과 모델 선택은 계속 Grok Build가 맡습니다. 며칠에 걸쳐 만드는 기능이나 다른 사람이 읽을 보고서처럼, 한 번 앉은 자리에서 끝나지 않는 일에 잘 맞습니다.
17
+ Grok Build 세션이 길어지면 대화가 압축되고, 새 세션은 앞 세션이 알던 내용을 모른 채 시작하며, "다 됐다"는 말도 모델이 그렇게 말했다는 뜻일 때가 많습니다. LitGrok은 세션마다 따라갈 순서를 줍니다. 첫 수정 전에 계획을 글로 남기고, 그 계획에 비추어 확인하고, 다음 세션이 읽을 인수인계 문서를 남깁니다. 스킬 42개, 에이전트 11개, 프로젝트 규칙 하나, 훅 등록 열두 개가 들어 있고, 세션 실행과 모델 선택은 계속 Grok Build가 맡습니다. 며칠에 걸쳐 만드는 기능이나 다른 사람이 읽을 보고서처럼, 한 번 앉은 자리에서 끝나지 않는 일에 잘 맞습니다.
18
18
 
19
19
  ## 30초 설치
20
20
 
@@ -24,7 +24,7 @@ Node.js와 Grok Build가 있으면 됩니다. 써 보고 싶은 프로젝트에
24
24
  npm exec --yes --package @litfamily/litgrok@latest -- litgrok install
25
25
  ```
26
26
 
27
- 파일은 `<project>/.grok/`에 들어갑니다. `~/.grok/`에 설치하려면 `--user`를, 이 릴리스로 고정하려면 `--package @litfamily/litgrok@1.0.27`을 쓰세요. `--dry-run`을 붙이면 파일을 쓰기 전에 들어갈 경로를 모두 보여 줍니다.
27
+ 파일은 `<project>/.grok/`에 들어갑니다. `~/.grok/`에 설치하려면 `--user`를, 이 릴리스로 고정하려면 `--package @litfamily/litgrok@1.0.28`을 쓰세요. `--dry-run`을 붙이면 파일을 쓰기 전에 들어갈 경로를 모두 보여 줍니다.
28
28
 
29
29
  로컬 패키지로 써 보려면 실제 절대 경로를 변수에 넣고 두 줄을 따로 실행하세요.
30
30
 
@@ -73,7 +73,7 @@ npm exec --yes --package "$LITGROK_PACK" -- litgrok install
73
73
 
74
74
  ## 설치하면 달라지는 것
75
75
 
76
- 설치 프로그램이 스킬, 에이전트, 프로젝트 규칙, 훅을 `.grok/`에 복사합니다. [`hooks/hooks.json`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/hooks/hooks.json)에 있는 훅 등록 열한 개는 신뢰한 Git 루트에서만 동작하고, `.grok/litgrok/session-ledger/`에 이벤트 순서를 남깁니다. 모든 작업은 Grok 세션 안에서 돌고 백그라운드 작업은 없습니다. 세션이 끝나면 다음 세션이 이어받을 때까지 그 자리에 멈춰 있습니다.
76
+ 설치 프로그램이 스킬, 에이전트, 프로젝트 규칙, 훅을 `.grok/`에 복사합니다. [`hooks/hooks.json`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/hooks/hooks.json)에 있는 훅 등록 열두 개는 신뢰한 Git 루트에서만 동작하고, `.grok/litgrok/session-ledger/`에 이벤트 순서를 남깁니다. 모든 작업은 Grok 세션 안에서 돌고 백그라운드 작업은 없습니다. 세션이 끝나면 다음 세션이 이어받을 때까지 그 자리에 멈춰 있습니다.
77
77
 
78
78
  지금 어떤 LitGrok 스킬이 동작 중인지, 어떤 모델을 쓰는지, 컨텍스트를 얼마나 썼는지 보고 싶으면 `install --user --status-line`으로 상태 행을 켜세요. `~/.grok/config.toml`에 `[ui.status_line]`을 넣고, 파일이 이미 있으면 먼저 백업합니다. 프롬프트가 작업 흐름 스킬을 시작하면 지금 단계, 돌고 있는 도구, 마지막 테스트 결과도 함께 보입니다. 턴이 끝날 때 Grok의 터미널 알림을 받으려면 `--notify`를 붙이세요.
79
79
 
@@ -112,6 +112,6 @@ npm exec --yes --package @litfamily/litgrok@latest -- litgrok uninstall --user
112
112
 
113
113
  LitGrok 덕분에 같은 설명을 덜 반복하게 됐다면, [GitHub 스타](https://github.com/wjgoarxiv/litgrok) 하나가 다른 Grok Build 사용자에게 이 프로젝트를 알리는 데 도움이 됩니다.
114
114
 
115
- [상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/reference_ko-KR.md) · [변경 이력](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/CHANGELOG.md) · [개인정보](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/docs/privacy.md) · [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.27/LICENSE)
115
+ [상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/reference_ko-KR.md) · [변경 이력](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/CHANGELOG.md) · [개인정보](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/docs/privacy.md) · [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/LICENSE) · [상표 정책](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.28/TRADEMARK.md)
116
116
 
117
117
  커버의 모션은 LitFamily 모션 스킬로 만든 브랜드 연출입니다. 그려서 움직인 그림이라 실제 Grok 세션을 녹화한 장면은 들어 있지 않습니다.
package/TRADEMARK.md ADDED
@@ -0,0 +1,12 @@
1
+ # Trademark policy
2
+
3
+ The code in this repository is free to use under the MIT License (see `LICENSE`). The names **LitGrok**
4
+ and **LitFamily**, and the logos and mascot art, are not part of that license.
5
+
6
+ - You can fork, change and share the code under MIT.
7
+ - If you publish a changed version, give it a different name and logo, and do not suggest that the
8
+ LitGrok maintainers made or endorse it.
9
+ - You can say in plain text that your project is "based on LitGrok" or "a fork of LitGrok".
10
+ - Unchanged copies, such as mirrors and package caches, may keep the name.
11
+
12
+ Questions: open an issue at https://github.com/wjgoarxiv/litgrok/issues.
package/bin/litgrok.mjs CHANGED
@@ -95,6 +95,8 @@ const PRE_MANIFEST_PAYLOAD_HASHES = Object.freeze({
95
95
  'skills/lit-comprehend/references/worked-explainer.md': 'c6ecde363a39760632e8c7f296d14ea32df508afebb99c101cc68ee021d0fac4',
96
96
  'skills/lit-handoff/SKILL.md': '7152d6399fd778ab3d16e1abad2ec97e2f4be4350cd3993cdde038cc1211dd80',
97
97
  'skills/lit-plan/SKILL.md': '0efb869398cedf36128ec2160eee660da8df8d324cdc18f56256fe7d08ff8d78',
98
+ 'skills/lit-plan/references/plan-schema.md': '1799c070eb8cf465f1737ac7d25409b6bfb245beb4c589e7bd69e2058861d74d',
99
+ 'skills/lit-plan/scripts/scaffold-plan.mjs': '3b5784f7c39af28afcf8d9f3df872cbfd3bf2bb46855b1d0370145ac18cff876',
98
100
  'skills/lit-recap/SKILL.md': '65f76df0ce9170bbc0c6a0bd7110f6a6eb0169e6f92c4fc3bd32e28cf0232dc1',
99
101
  'skills/lit-scientific-visualization/SKILL.md': 'ffc3b2ea49dd7e7c4c7d4568f289df294a3a30f953c11039f98aaf6f8fb983ee',
100
102
  'skills/lit-scientific-visualization/scripts/verify-canonical-corpus.mjs': 'a1cfe0578195098dc4afc2d25f0d391f38aeaa57cd3970fa7dca51e20cbf929d',
@@ -1 +1 @@
1
- <svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="local: 1.0.27"><title>local: 1.0.27</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="290" transform="scale(.1)">local</text><text x="965" y="140" textLength="870" transform="scale(.1)" fill="#080D14">1.0.27</text></g></svg>
1
+ <svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="local: 1.0.28"><title>local: 1.0.28</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="290" transform="scale(.1)">local</text><text x="965" y="140" textLength="870" transform="scale(.1)" fill="#080D14">1.0.28</text></g></svg>
package/docs/reference.md CHANGED
@@ -43,7 +43,7 @@ flowchart TD
43
43
  - A project rule at `.grok/rules/00-litgrok.md`.
44
44
  - A bounded `SessionStart` hook that prints the standard mark once per validated session and announces the installed payload.
45
45
  - A `PreToolUse` hook that rejects hedge phrasing in pending reader-facing writes while skipping quoted state enums, JSON/YAML scalars, fenced code, and status tables. The host treats only an explicit deny with exit 2 as blocking; exit 0 allows, while timeouts, crashes, and malformed output fail-open and the write proceeds.
46
- - Recording-only `UserPromptSubmit`, `PostToolUse`, `PostToolUseFailure`, `Stop`, `StopFailure`, `SubagentStart`, `SubagentStop`, `PreCompact`, and `PostCompact` hooks. They append bounded package-owned records under `.grok/litgrok/session-ledger/`, emit no stdout, and do not claim access to undocumented event fields. Each append checks only the ledger's first record for this session's identity, seals a torn last line so it is skipped, and moves a ledger past 8 MiB aside as `<key>.<n>.jsonl` before starting a fresh one, keeping the two newest segments; one hook rotates at a time, and the Stop gates read the newest segment and the live ledger. An oversized ledger whose first record belongs to another session is refused, never moved. `.grok/litgrok/` gets a `.gitignore` containing `*` when LitGrok first writes there.
46
+ - Recording-only `UserPromptSubmit`, `PostToolUse`, `PostToolUseFailure`, `Stop`, `StopFailure`, `SubagentStart`, `SubagentStop`, `PreCompact`, `PostCompact`, and `SessionEnd` hooks. They append bounded package-owned records under `.grok/litgrok/session-ledger/`, emit no stdout, and do not claim access to undocumented event fields. Each append checks only the ledger's first record for this session's identity, seals a torn last line so it is skipped, and moves a ledger past 8 MiB aside as `<key>.<n>.jsonl` before starting a fresh one, keeping the two newest segments; one hook rotates at a time, and the Stop gates read the newest segment and the live ledger. An oversized ledger whose first record belongs to another session is refused, never moved. `.grok/litgrok/` gets a `.gitignore` containing `*` when LitGrok first writes there.
47
47
  - A dependency-free `npx` installer that copies the complete packaged `.grok/` tree into user or project Grok paths.
48
48
  - A root-level `plugin.json` Grok plugin manifest in the shape accepted by `grok plugin validate`; the validator reports the shipped skill directory, agent directory, and hook manifests. LitGrok ships eleven Grok-native agent definitions under `.grok/agents/`.
49
49
  - Grok Build supports these plugin, skill, agent, hook, and rule surfaces. The GitHub repository also carries a skills-only Cursor-format manifest and one-entry marketplace in `.cursor-plugin/`, so Cursor and Grok Bot can load the skills; it stays out of the npm package, and a public Cursor Marketplace listing is not live yet. LitGrok ships no MCP server configuration, plugin-supplied LSP server configuration, command catalog, output styles, or TUI/skin surface; those remain unshipped.
@@ -80,7 +80,7 @@ npm exec --yes --package @litfamily/litgrok@latest -- litgrok install
80
80
  Pin a version when you need a reproducible install:
81
81
 
82
82
  ```bash
83
- npm exec --yes --package @litfamily/litgrok@1.0.27 -- litgrok install
83
+ npm exec --yes --package @litfamily/litgrok@1.0.28 -- litgrok install
84
84
  ```
85
85
 
86
86
  Preview without writing files:
@@ -137,6 +137,10 @@ The timer is the time since Grok's `turn.started_at_ms`. Grok Build 1.0.13 sends
137
137
 
138
138
  The stage map shows the session's place in the LIT workflow, for example `plan ✓ ━━━━ [work 3/7] ━━━━ review · ──── done ·`, with the detail line `└ task 3/7 ▮▮▮▯▯▯▯ · next ▸ 4. README demo GIF · tests ✓ 214` and `⠹ Bash 0:31` at its right edge. The map appears once the session has a workflow stage; `LITGROK_HUD_LINES=1` hides the card. The `UserPromptSubmit` hook sets the stage from the first visible match among `deep-interview` (interview), `lit-plan` (plan), `start-work`, `litwork` or bare `lit` (work) and `review-work` (review), with the same code masking as the discipline, and records it as `stage` in the ledger. `lit review` as the first words of the prompt is the spaced spelling of `review-work`: it switches to the review stage and sets no status-row discipline. `lit brainstorm`, `lit ideation`, `lit ideate`, `lit idea`, `lit ideas` and `lit-brainstorm` as the first words open `lit-brainstorm`: the status row shows that name, the ledger record carries no stage and arms no plan gate, and a running stage stays as it is. A bare `lit` continues a stage that is running: it clears `ended` and changes neither the stage, the stages visited, the plan count nor the test verdict, unless the stage is `done` or none is set, when it starts work. A named skill switches the stage, and so does `lit plan` as the first words of the prompt, which also marks the turn `lit-plan` for the plan gate and the status row. `lit new` or `lit restart` as the first words of the prompt clears the stages visited, the plan count and the test verdict before it sets work; the plan count is then read again from `plans/`. State that is missing, malformed, oversized or from another session is replaced by a first activation, and the prompt hook still writes no stdout. The `PreToolUse` hook, registered for every tool, records only the tool name; a call is in flight while that record is the turn's newest tool record, and the line shows Grok's name mapped to a short label (`run_terminal_command` as `Bash`, `search_replace` as `Edit`) with the time since the record. The `PostToolUse` hook, now also registered for every tool, and `PostToolUseFailure` add `test: { verdict, count }` when `toolInput.command` calls a test runner (npm, pnpm, yarn or bun `test`, `node --test`, vitest, jest, mocha, pytest, unittest, cargo, go, deno, make, gradle, mvn, rspec, ctest, swift or dotnet test) outside a heredoc body or a quoted string; the verdict comes from the failure event, a non-zero exit code, or the runner's pass and fail counts in `toolResult`, and nothing is recorded when the outcome cannot be read. Because the line must survive a ledger tail of 128 KiB, the hooks also keep `<session-hash>.workflow.json` beside the ledger: stage, stages visited, whether the stage's turn has ended, the newest `plans/*.md` checkbox count (`- [x] N.` over all column-zero rows outside fences) with the first unchecked row's title, control characters removed and cut to 60 characters, and the last test verdict, at most 4 KiB, written atomically, refused through a symlink and only once there is something to show. `Stop` closes the stage unless the plan gate or a handoff directive held the turn; a review that ends with every task checked becomes done. In colour, as the family's LIT card draws it, stages behind are grey with a tick, the current stage is an accent chip with dark text and stages ahead are grey with a dot; rails into a passed or current stage are the accent, the rail leaving the current stage is a grey `━` and those further on are grey `─`, and while a turn runs one pink cell moves along the rail into the current stage at each redraw. The tool step is the bold accent and the test badge green or red. The stage names are LitGrok's own (`interview`, `plan`, `work`, `review`, `done`); LitGrok has no PIN-to-RECORD loop skill. Narrow rows shorten the rails to two cells and one, then drop the stage names, and finally keep only the current stage.
139
139
 
140
+ Other sessions of the same workspace get one row each under the card, or under the single row when this session has no card: `● start-work · w2B:p2 running`, `· lit-plan idle`, `✓ start-work done`. Running rows come first, then idle, then done, newest first, at most four. The rows come from liveness records: `PostToolUse` and `PostToolUseFailure` write `alive`, `Stop` writes `idle` and `SessionEnd` writes `ended` to `.grok/litgrok/liveness/<session-hash>.json`, with `HERDR_PANE_ID` kept only when it is a short plain token. A repeat of the same state within 30 seconds writes nothing, a symlinked record or folder is refused, and a failed write never changes the hook's output. A record older than 15 minutes reads as ended, so a session that dies without `SessionEnd` drops off. A start-work whose work stage ended with every plan task checked, or that reached `done`, shows `done` for 60 seconds and then leaves; an ended session is not shown. `LITGROK_HUD_LINES=1` keeps the single row without these rows.
141
+
142
+ Planning has two more aids. After `lit-plan` saves `plans/<slug>.md`, a bare `go` in the same conversation within 30 minutes of the plan file's modification time loads start-work on that plan; Grok Build drops an allowing prompt hook's output, so this route lives in the project rule and the lit-plan skill, not in a hook. And a todo that names an absolute path outside the project needs a `Scope roots: <path> (<actions>)` line: `scaffold-plan.mjs --check` and the Stop plan gate (within its two-block cap) name each uncovered folder with the exact line to paste. Fenced blocks and commands quoted in inline code do not count.
143
+
140
144
  `install --user --notify` appends a managed `[ui.notifications]` table with `condition = "always"` and `events = ["turn_complete", "approval_required", "agent_error"]`, so Grok's own terminal notification also fires while the terminal has focus. It follows the status-line rules: user scope only, off by default, a backup before any change, no change when any `notifications` setting already exists or `ui` is a top-level value or array, and user uninstall removes only the unchanged table. Grok Build 1.0.13 documents this table, yet its `grok inspect` lists `ui.notifications` as an unrecognized config key; that warning comes from Grok and changes nothing else in the file.
141
145
 
142
146
  ### Automatic handoff (opt-in)
@@ -283,7 +287,7 @@ npm pack --dry-run --json
283
287
 
284
288
  A passing static test does not prove that a live `grok` binary loaded the files.
285
289
 
286
- With Grok Build installed, run `grok inspect --json` from the Git project root and confirm that the rule path is listed. A plain folder can still show the skills and rules while reporting zero hooks. For a new disposable project, create the Git root yourself with `git init`; an existing repository should use its actual root. After granting trust, open `/skills` and `/hooks` to verify the catalog and eleven hook registrations. These are host-side checks; this package does not create the Git root, change trust, log in to Grok, or claim their result.
290
+ With Grok Build installed, run `grok inspect --json` from the Git project root and confirm that the rule path is listed. A plain folder can still show the skills and rules while reporting zero hooks. For a new disposable project, create the Git root yourself with `git init`; an existing repository should use its actual root. After granting trust, open `/skills` and `/hooks` to verify the catalog and twelve hook registrations. These are host-side checks; this package does not create the Git root, change trust, log in to Grok, or claim their result.
287
291
 
288
292
  ## Safety
289
293
 
@@ -43,7 +43,7 @@ flowchart TD
43
43
  - `.grok/rules/00-litgrok.md` project rule
44
44
  - 설치된 payload를 짧게 알리는 `SessionStart` hook
45
45
  - reader-facing write의 hedge 표현을 차단하되 quoted state enum, JSON/YAML scalar, fenced code, status table은 제외하는 `PreToolUse` hook. Host는 명시적인 deny와 exit 2만 차단으로 처리합니다. exit 0은 허용이고 timeout, crash, malformed output은 fail-open이므로 write가 진행됩니다.
46
- - `.grok/litgrok/session-ledger/`에 bounded package-owned record만 추가하는 `UserPromptSubmit`, `PostToolUse`, `PostToolUseFailure`, `Stop`, `StopFailure`, `SubagentStart`, `SubagentStop`, `PreCompact`, `PostCompact` hook. stdout을 출력하지 않으며 문서화되지 않은 event field 접근을 주장하지 않습니다. 기록할 때마다 ledger의 첫 record로만 이 세션의 identity를 확인하고, 끊긴 마지막 줄은 건너뛸 수 있게 닫으며, 8 MiB를 넘은 ledger는 `<key>.<n>.jsonl`로 옮긴 뒤 새로 시작하고, segment는 최근 두 개만 남깁니다. 한 번에 한 hook만 옮기며, Stop gate는 가장 최근 segment와 현재 ledger를 함께 읽습니다. 첫 record가 다른 세션의 것인 큰 ledger는 옮기지 않고 거부합니다. LitGrok이 `.grok/litgrok/`에 처음 쓸 때 `*` 한 줄짜리 `.gitignore`도 만듭니다.
46
+ - `.grok/litgrok/session-ledger/`에 bounded package-owned record만 추가하는 `UserPromptSubmit`, `PostToolUse`, `PostToolUseFailure`, `Stop`, `StopFailure`, `SubagentStart`, `SubagentStop`, `PreCompact`, `PostCompact`, `SessionEnd` hook. stdout을 출력하지 않으며 문서화되지 않은 event field 접근을 주장하지 않습니다. 기록할 때마다 ledger의 첫 record로만 이 세션의 identity를 확인하고, 끊긴 마지막 줄은 건너뛸 수 있게 닫으며, 8 MiB를 넘은 ledger는 `<key>.<n>.jsonl`로 옮긴 뒤 새로 시작하고, segment는 최근 두 개만 남깁니다. 한 번에 한 hook만 옮기며, Stop gate는 가장 최근 segment와 현재 ledger를 함께 읽습니다. 첫 record가 다른 세션의 것인 큰 ledger는 옮기지 않고 거부합니다. LitGrok이 `.grok/litgrok/`에 처음 쓸 때 `*` 한 줄짜리 `.gitignore`도 만듭니다.
47
47
  - package의 `.grok/` tree 전체를 user 또는 project 경로에 복사하는 dependency-free `npx` installer
48
48
  - Grok Build가 지원하는 plugin manifest 형식의 root-level `plugin.json`을 제공합니다. `grok plugin validate`가 이를 검증하고 `.grok/skills`, `.grok/agents`, hook manifest를 가리킵니다. `.grok/agents/` 아래 Grok-native agent 11개와 hook/rule을 함께 제공합니다.
49
49
  - GitHub 저장소에는 Cursor와 Grok Bot이 skill을 불러오도록 skill만 선언한 Cursor 형식 manifest와 항목 하나짜리 marketplace가 `.cursor-plugin/`에 있습니다. npm package에는 들어가지 않으며, 공개 Cursor Marketplace 등록은 아직 준비 중입니다.
@@ -81,7 +81,7 @@ npm exec --yes --package @litfamily/litgrok@latest -- litgrok install
81
81
  재현 가능한 설치는 버전을 고정합니다.
82
82
 
83
83
  ```bash
84
- npm exec --yes --package @litfamily/litgrok@1.0.27 -- litgrok install
84
+ npm exec --yes --package @litfamily/litgrok@1.0.28 -- litgrok install
85
85
  ```
86
86
 
87
87
  파일을 쓰지 않고 미리보기:
@@ -138,6 +138,10 @@ refresh_interval = 2
138
138
 
139
139
  단계 지도는 세션이 LIT 작업 흐름의 어디쯤인지 보여 줍니다. 예를 들면 `plan ✓ ━━━━ [work 3/7] ━━━━ review · ──── done ·`이고, 그 아래 세부 줄은 `└ task 3/7 ▮▮▮▯▯▯▯ · next ▸ 4. README demo GIF · tests ✓ 214`에 오른쪽 끝 `⠹ Bash 0:31`입니다. 지도는 세션에 작업 흐름 단계가 생기면 나타나고, `LITGROK_HUD_LINES=1`이면 카드 전체를 숨깁니다. `UserPromptSubmit` 훅은 프롬프트에서 보이는 첫 일치 항목으로 단계를 정합니다. `deep-interview`는 interview, `lit-plan`은 plan, `start-work`·`litwork`·`lit`만 쓴 경우는 work, `review-work`는 review이며, 코드 가리기 규칙은 discipline과 같고, ledger에 `stage`로 남깁니다. 프롬프트가 `lit review`로 시작하면 `review-work`의 띄어쓰기 표기로 보고 review 단계로 바꾸며 상태 줄 discipline은 정하지 않습니다. `lit brainstorm`, `lit ideation`, `lit ideate`, `lit idea`, `lit ideas`, `lit-brainstorm`으로 시작하면 `lit-brainstorm`을 엽니다. 상태 줄에 그 이름이 나오고, ledger 기록에는 stage가 없으며 plan gate도 켜지 않고, 진행 중인 단계는 그대로 둡니다. 모든 도구에 등록한 `PreToolUse` 훅은 도구 이름만 기록합니다. 그 기록이 턴의 가장 최근 도구 기록이면 실행 중으로 보고, Grok의 도구 이름을 짧은 이름(`run_terminal_command`는 `Bash`, `search_replace`는 `Edit`)으로 바꿔 기록 이후 경과 시간과 함께 보여 줍니다. 이제 모든 도구에 등록한 `PostToolUse` 훅과 `PostToolUseFailure` 훅은 `toolInput.command`가 테스트 실행기(npm·pnpm·yarn·bun `test`, `node --test`, vitest, jest, mocha, pytest, unittest, cargo, go, deno, make, gradle, mvn, rspec, ctest, swift, dotnet test)를 heredoc 본문이나 따옴표 문자열 밖에서 부를 때 `test: { verdict, count }`를 더합니다. 결과는 실패 이벤트, 0이 아닌 종료 코드, `toolResult`에 찍힌 통과·실패 수로 정하고, 결과를 읽을 수 없으면 남기지 않습니다. ledger는 끝의 128 KiB만 읽으므로 훅은 ledger 옆에 `<session-hash>.workflow.json`도 둡니다. 단계, 거친 단계, 그 단계의 턴이 끝났는지, 가장 최근 `plans/*.md`의 체크 수(펜스 밖 첫 열 작업 행 가운데 `- [x] N.`의 수)와 체크하지 않은 첫 행의 제목(제어 문자를 지우고 60자로 자름), 마지막 테스트 결과를 담으며, 4 KiB 이하로 원자적으로 쓰고, 심볼릭 링크는 거부하며, 보여 줄 것이 생겼을 때만 만듭니다. `Stop`은 plan gate나 핸드오프 지시가 턴을 붙잡지 않았으면 단계를 닫고, 모든 작업이 체크된 상태로 끝난 검토는 done이 됩니다. 색을 쓰면 패밀리 LIT 카드처럼 지나온 단계는 회색에 체크, 지금 단계는 어두운 글자의 강조색 칩, 앞으로 올 단계는 회색에 점입니다. 지나온 단계와 지금 단계로 들어가는 레일은 강조색, 지금 단계에서 나가는 레일은 회색 `━`, 그 뒤는 회색 `─`이고, 턴이 도는 동안 분홍 칸 하나가 다시 그릴 때마다 지금 단계로 들어가는 레일을 따라 움직입니다. 도구 표시는 굵은 강조색, 테스트 표시는 초록이나 빨강입니다. 단계 이름은 LitGrok 자신의 것(`interview`, `plan`, `work`, `review`, `done`)이고, LitGrok에는 PIN에서 RECORD로 가는 루프 스킬이 없습니다. 줄이 좁으면 레일을 두 칸, 한 칸으로 줄이고, 이어서 단계 이름을 빼며, 마지막에는 지금 단계만 남깁니다.
140
140
 
141
+ 같은 작업 공간의 다른 세션은 카드 아래(이 세션에 카드가 없으면 한 줄 행 아래)에 한 줄씩 나옵니다. `● start-work · w2B:p2 running`, `· lit-plan idle`, `✓ start-work done` 같은 모양이고, 실행 중, 쉬는 중, 끝냄 순서로 최신 것부터 네 줄까지 보입니다. 이 줄은 활동 기록에서 옵니다. `PostToolUse`와 `PostToolUseFailure`는 `alive`, `Stop`은 `idle`, `SessionEnd`는 `ended`를 `.grok/litgrok/liveness/<session-hash>.json`에 쓰고, `HERDR_PANE_ID`는 짧은 일반 토큰일 때만 남깁니다. 같은 상태가 30초 안에 다시 오면 쓰지 않고, 심볼릭 링크인 기록이나 폴더는 거부하며, 쓰기에 실패해도 훅 출력은 바뀌지 않습니다. 15분이 지난 기록은 끝난 것으로 보므로 `SessionEnd` 없이 멈춘 세션도 사라집니다. 모든 계획 작업을 체크한 채 work 단계가 끝났거나 `done`에 이른 start-work는 60초 동안 `done`으로 보인 뒤 사라지고, 끝난 세션은 보이지 않습니다. `LITGROK_HUD_LINES=1`이면 이 줄 없이 한 줄 행만 씁니다.
142
+
143
+ 계획에도 도움이 두 가지 더 있습니다. `lit-plan`이 `plans/<slug>.md`를 저장한 뒤 같은 대화에서 계획 파일 수정 시각으로부터 30분 안에 `go`만 입력하면 그 계획으로 start-work를 시작합니다. Grok Build는 허용한 프롬프트 훅의 출력을 버리므로 이 경로는 훅이 아니라 프로젝트 규칙과 lit-plan 스킬에 들어 있습니다. 또 할 일이 프로젝트 밖 절대 경로를 가리키면 `Scope roots: <path> (<actions>)` 줄이 있어야 합니다. `scaffold-plan.mjs --check`와 Stop plan gate(두 번 block 한도 안에서)가 덮이지 않은 폴더마다 붙여 넣을 줄을 그대로 알려 줍니다. 펜스 블록 안의 경로와 인라인 코드로 감싼 명령은 세지 않습니다.
144
+
141
145
  `install --user --notify`는 관리 표식이 붙은 `[ui.notifications]` 표를 추가합니다. `condition = "always"`와 `events = ["turn_complete", "approval_required", "agent_error"]`를 담아 터미널을 보고 있을 때도 Grok 자체 터미널 알림이 뜨게 합니다. 규칙은 상태 행과 같습니다. 사용자 범위에서만 쓸 수 있고, 기본은 꺼져 있으며, 바꾸기 전에 백업하고, `notifications` 설정이 이미 있거나 `ui`가 최상위 값 또는 배열이면 바꾸지 않으며, 사용자 범위 제거는 그대로인 표만 지웁니다. Grok Build 1.0.13은 이 표를 문서에 적어 두었지만 `grok inspect`는 `ui.notifications`를 인식하지 못한 설정 키로 표시합니다. 이 경고는 Grok이 내는 것이고 파일의 다른 부분은 바뀌지 않습니다.
142
146
 
143
147
  ### 자동 핸드오프 (선택)
@@ -280,7 +284,7 @@ npm pack --dry-run --json
280
284
 
281
285
  정적 테스트가 통과해도 live `grok` 바이너리가 파일을 읽었다는 뜻은 아닙니다.
282
286
 
283
- Grok Build가 설치된 환경에서는 Git project root에서 `grok inspect --json`을 실행해 rule 경로가 표시되는지 확인합니다. 일반 폴더에서는 skill과 rule이 보여도 hook이 0개일 수 있습니다. 새 disposable project는 사용자가 `git init`을 실행하고, 기존 저장소는 실제 root를 사용합니다. trust 허용 뒤 `/skills`와 `/hooks`에서 skill catalog와 열한 hook 등록을 확인합니다. 이는 host 측 확인 절차이며, LitGrok이 Git root나 trust를 바꾸거나 Grok에 로그인하거나 그 결과를 주장하지 않습니다.
287
+ Grok Build가 설치된 환경에서는 Git project root에서 `grok inspect --json`을 실행해 rule 경로가 표시되는지 확인합니다. 일반 폴더에서는 skill과 rule이 보여도 hook이 0개일 수 있습니다. 새 disposable project는 사용자가 `git init`을 실행하고, 기존 저장소는 실제 root를 사용합니다. trust 허용 뒤 `/skills`와 `/hooks`에서 skill catalog와 열두 hook 등록을 확인합니다. 이는 host 측 확인 절차이며, LitGrok이 Git root나 trust를 바꾸거나 Grok에 로그인하거나 그 결과를 주장하지 않습니다.
284
288
 
285
289
  ## 안전
286
290
 
package/hooks/hooks.json CHANGED
@@ -11,6 +11,17 @@
11
11
  ]
12
12
  }
13
13
  ],
14
+ "SessionEnd": [
15
+ {
16
+ "hooks": [
17
+ {
18
+ "type": "command",
19
+ "command": "node \"$GROK_PLUGIN_ROOT/.grok/hooks/session-end.mjs\"",
20
+ "timeout": 5
21
+ }
22
+ ]
23
+ }
24
+ ],
14
25
  "UserPromptSubmit": [
15
26
  {
16
27
  "hooks": [
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litfamily/litgrok",
3
- "version": "1.0.27",
3
+ "version": "1.0.28",
4
4
  "description": "Installer for LitGrok: skills, a project rule and hooks that help xAI Grok Build sessions plan, build, check and hand off their work.",
5
5
  "keywords": [
6
6
  "grok",
@@ -70,6 +70,7 @@
70
70
  "docs/assets/skills",
71
71
  "CONTRIBUTING.md",
72
72
  "SECURITY.md",
73
+ "TRADEMARK.md",
73
74
  "CODE_OF_CONDUCT.md",
74
75
  "SUPPORT.md",
75
76
  "docs/privacy.md",
package/plugin.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "litgrok",
3
- "version": "1.0.27",
3
+ "version": "1.0.28",
4
4
  "description": "Grok Build skills, project rules, and bounded lifecycle hooks for evidence-first lit work.",
5
5
  "author": {
6
6
  "name": "LitGrok contributors"