@litfamily/litgrok 1.0.10 → 1.0.12

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.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "litgrok",
3
- "version": "1.0.10",
3
+ "version": "1.0.12",
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"
package/CHANGELOG.md CHANGED
@@ -2,6 +2,14 @@
2
2
 
3
3
  ## Unreleased
4
4
 
5
+ ## 1.0.12 — 2026-09-30
6
+
7
+ - The GitHub pages, in English and Korean, gained a short motion film under "Watch it in motion": one working session in about twenty seconds, from typing a goal to handing the work to a fresh terminal. It is animated artwork, and the film files stay on GitHub, outside the npm package.
8
+
9
+ ## 1.0.11 — 2026-09-29
10
+
11
+ - The READMEs and the npm install page, in English and Korean, are rewritten in plainer language, with the reason before each switch. The npm page stays a short install card that links to the full guide on GitHub.
12
+
5
13
  ## 1.0.10 — 2026-09-29
6
14
 
7
15
  - lit-typographic-motion: the motion runtime now pins `ws` 8.22.0, which fixes a memory-exhaustion denial of service and an uninitialized-memory disclosure in 8.18.3. Run `litgrok-ai motion-runtime install` again after upgrading.
package/README.md CHANGED
@@ -1,18 +1,18 @@
1
- <p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/cover-motion-still.webp" /><source media="(prefers-reduced-motion: no-preference)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/cover-motion.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: five 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.12/docs/assets/cover-motion-still.webp" /><source media="(prefers-reduced-motion: no-preference)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/docs/assets/cover-motion.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/docs/assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: five 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
  Make something useful in Grok Build. Leave the checked result and the next step with your project.
7
7
 
8
- **[Full guide and skills gallery on GitHub](https://github.com/wjgoarxiv/litgrok#readme)** · [한국어](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.10/docs/reference.md)
8
+ **[Full guide and skills gallery on GitHub](https://github.com/wjgoarxiv/litgrok#readme)** · [한국어](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.12/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.10/docs/assets/readme/badge-version.svg" alt="1.0.10" /></a>
12
- <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/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.12/docs/assets/readme/badge-version.svg" alt="1.0.12" /></a>
12
+ <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/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.10/docs/reference.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/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.10/docs/assets/cover-motion.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/readme/lucide-play.svg" width="16" alt="" /> Cover motion</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/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.12/docs/reference.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/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.12/docs/assets/cover-motion.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/docs/assets/readme/lucide-play.svg" width="16" alt="" /> Cover motion</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/docs/assets/readme/lucide-shield-check.svg" width="16" alt="" /> MIT</a></p>
16
16
 
17
17
  LitGrok gives Grok Build a way of working: plan the change, build it, check it, and leave a handoff the next session can read. It ships 38 skills, 11 agents, one project rule, and eleven hook registrations. Grok Build still runs the session and chooses the model.
18
18
 
@@ -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.10` 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.12` 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
 
@@ -35,13 +35,13 @@ npm exec --yes --package "$LITGROK_PACK" -- litgrok install
35
35
 
36
36
  ## The first thing to type
37
37
 
38
- Open or restart Grok Build at the project's Git root, then review and trust its hooks with `/hooks-trust` (on the observed Grok Build 1.0.23 host, `grok --trust inspect --json` also works). A plain folder still loads skills and rules, but its hooks stay unavailable. Then send:
38
+ Open (or restart) Grok Build from the project's Git root. Grok runs project hooks only after you trust them, so review and trust them in `/hooks-trust`; on Grok Build 1.0.23, `grok --trust inspect --json` did the same. In a plain folder without Git, the skills and rules load but the hooks stay off. Then send:
39
39
 
40
40
  ```text
41
41
  /litwork Build a to-do list in one index.html with no external dependencies. Implement add, complete, and delete. Leave the checks performed and the next step. Do not open a browser automatically; give me the steps to check it myself.
42
42
  ```
43
43
 
44
- Open `index.html` yourself and try adding, completing, and deleting an item. Leave any check you did not run marked unverified.
44
+ Then open `index.html` yourself and add, complete and delete an item. That click-through is the real test; anything you didn't try stays marked unverified.
45
45
 
46
46
  ## Carry the work into the next session
47
47
 
@@ -51,7 +51,7 @@ For a larger change, start with `/lit-plan`, read the plan it saves, then run `/
51
51
  /lit-handoff Record what we built, what we checked, and what remains. Tell me where you saved the handoff.
52
52
  ```
53
53
 
54
- Next time, give Grok Build the path it returned and ask it to read the handoff and check the current files before continuing. A handoff does not resume anything on its own.
54
+ Next time, give Grok Build the path it returned and ask it to read the handoff and check the current files before it continues.
55
55
 
56
56
  ## Routes people use
57
57
 
@@ -70,13 +70,21 @@ Beyond code, `lit-pptx` makes slide decks, `lit-docx` makes reports and Word doc
70
70
 
71
71
  ## What changes after install
72
72
 
73
- 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.10/hooks/hooks.json) run only in a trusted Git root, and they record the order of events in `.grok/litgrok/session-ledger/`. LitGrok does not schedule background work or keep going after the session ends.
73
+ 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.12/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.
74
74
 
75
- An optional status row is available at user level with `install --user --status-line`. It adds `[ui.status_line]` to `~/.grok/config.toml` and backs up an existing file first.
75
+ 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.
76
76
 
77
77
  ## Safety and uninstall
78
78
 
79
- The installer checks that it owns a file before it upgrades or removes it, and refuses to overwrite modified, foreign, or unsafe files. `CI`, `NO_COLOR` (even empty), `--no-color`, and `--dry-run` are no-write previews, even with `--yes`. A non-interactive run without `--yes` is a preview too.
79
+ Before it upgrades or removes a file, the installer checks that the file is one it put there. If any file was edited, belongs to something else or looks unsafe, it stops before writing anything and names that file.
80
+
81
+ Some runs only preview: the installer lists what it would do, prints `no files written`, and stops, even with `--yes`. That happens with:
82
+
83
+ - `--dry-run`, when you want to see the plan first;
84
+ - `--no-color`, or `NO_COLOR` in the environment, even empty (unset it when you mean to install);
85
+ - `CI` in the environment, so CI jobs always get a preview.
86
+
87
+ Without `--yes`, a run with no terminal attached, such as a script, is a preview too.
80
88
 
81
89
  Uninstall with the same scope you installed with:
82
90
 
@@ -85,18 +93,18 @@ npm exec --yes --package @litfamily/litgrok@latest -- litgrok uninstall
85
93
  npm exec --yes --package @litfamily/litgrok@latest -- litgrok uninstall --user
86
94
  ```
87
95
 
88
- The installer never runs `git init`, grants hook trust, writes login state or API keys, or chooses a model. A passing package test does not prove live Grok behavior; check `/hooks` and `grok inspect --json` from the repository root in your own session.
96
+ The installer never runs `git init`, trusts hooks, signs in or picks a model for you; those steps, and your API keys, stay with you in Grok Build. The package tests check the files we ship. To see what your own session loaded, open it from the repository root and check `/hooks` and `grok inspect --json`.
89
97
 
90
98
  ## If something does not work
91
99
 
92
- - **No hooks:** hooks need a trusted Git project root. For a new project, run `git init` yourself before trusting it; for an existing one, open Grok Build from its actual root.
93
- - **Nothing was written:** one of the preview conditions above applied. Check that the installer reports actual writes.
94
- - **No status row:** the row comes from user or administrator configuration. Grok does not read it from project or plugin configuration.
100
+ - **No hooks:** Grok runs hooks only from a trusted Git project root. For a new project, run `git init` yourself, then trust it; for an existing one, open Grok Build from its real root.
101
+ - **Nothing was written:** the output says `no files written` and names the reason (`DRY RUN`, `NO COLOR` or `NON-INTERACTIVE`). Fix that case from the list above and run the install again.
102
+ - **No status row:** Grok reads the row from user or administrator configuration, not from a project or plugin, so add it with `install --user --status-line`.
95
103
 
96
104
  ---
97
105
 
98
106
  **[Full guide, skills gallery and troubleshooting on GitHub →](https://github.com/wjgoarxiv/litgrok#readme)**
99
107
 
100
- [Reference](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/reference.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/CHANGELOG.md) · [Privacy](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/privacy.md) · [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/LICENSE)
108
+ [Reference](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/docs/reference.md) · [Changelog](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/CHANGELOG.md) · [Privacy](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/docs/privacy.md) · [MIT license](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/LICENSE)
101
109
 
102
- The cover is brand motion made with the LitFamily motion skill, not a recording of a Grok task execution.
110
+ 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.10/docs/assets/cover-motion-still.webp" /><source media="(prefers-reduced-motion: no-preference)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/cover-motion.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/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.12/docs/assets/cover-motion-still.webp" /><source media="(prefers-reduced-motion: no-preference)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/docs/assets/cover-motion.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/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
  Grok Build에서 작은 결과물을 만들고, 확인한 내용과 다음 할 일을 프로젝트에 남기세요.
7
7
 
8
- **[GitHub에서 전체 안내와 스킬 갤러리 보기](https://github.com/wjgoarxiv/litgrok/blob/main/README_ko-KR.md)** · [English](https://github.com/wjgoarxiv/litgrok#readme) · [설치](#30초-설치) · [상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/reference_ko-KR.md)
8
+ **[GitHub에서 전체 안내와 스킬 갤러리 보기](https://github.com/wjgoarxiv/litgrok/blob/main/README_ko-KR.md)** · [English](https://github.com/wjgoarxiv/litgrok#readme) · [설치](#30초-설치) · [상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/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.10/docs/assets/readme/badge-version.svg" alt="1.0.10" /></a>
12
- <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/readme/badge-license.svg" alt="MIT 라이선스" /></a>
11
+ <a href="#30초-설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/docs/assets/readme/badge-version.svg" alt="1.0.12" /></a>
12
+ <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/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.10/docs/reference_ko-KR.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/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.10/docs/assets/cover-motion.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/assets/readme/lucide-play.svg" width="16" alt="" /> 커버 모션</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/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.12/docs/reference_ko-KR.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/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.12/docs/assets/cover-motion.webp"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/docs/assets/readme/lucide-play.svg" width="16" alt="" /> 커버 모션</a> &nbsp; <a href="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/docs/assets/readme/lucide-shield-check.svg" width="16" alt="" /> MIT</a></p>
16
16
 
17
- LitGrok은 Grok Build 위에 일하는 방식을 얹습니다. 계획하고, 만들고, 확인하고, 다음 세션이 읽을 인수인계 문서를 남기는 방식입니다. 스킬 38개, 에이전트 11개, 프로젝트 규칙 하나, 훅 등록 열한 개가 들어 있고, 세션 실행과 모델 선택은 계속 Grok Build가 맡습니다.
17
+ LitGrok은 Grok Build 위에서 계획하고, 만들고, 확인하고, 다음 세션이 읽을 인수인계 문서를 남기는 흐름을 더합니다. 스킬 38개, 에이전트 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.10`을 쓰세요. `--dry-run`을 붙이면 파일을 쓰기 전에 들어갈 경로를 모두 보여 줍니다.
27
+ 파일은 `<project>/.grok/`에 들어갑니다. `~/.grok/`에 설치하려면 `--user`를, 이 릴리스로 고정하려면 `--package @litfamily/litgrok@1.0.12`을 쓰세요. `--dry-run`을 붙이면 파일을 쓰기 전에 들어갈 경로를 모두 보여 줍니다.
28
28
 
29
29
  로컬 패키지로 써 보려면 실제 절대 경로를 변수에 넣고 두 줄을 따로 실행하세요.
30
30
 
@@ -35,13 +35,13 @@ npm exec --yes --package "$LITGROK_PACK" -- litgrok install
35
35
 
36
36
  ## 처음 입력해 볼 것
37
37
 
38
- 프로젝트의 Git 루트에서 Grok Build를 열거나 다시 시작하고, `/hooks-trust`에서 훅을 살펴본 뒤 신뢰하세요. 관찰된 Grok Build 1.0.23에서는 `grok --trust inspect --json`도 쓸 수 있습니다. 일반 폴더에서도 스킬과 규칙은 불러오지만 훅은 잡히지 않을 수 있습니다. 그다음 이렇게 보내 보세요.
38
+ 프로젝트의 Git 루트에서 Grok Build를 열거나 다시 시작합니다. Grok은 신뢰한 프로젝트 훅만 실행하니, `/hooks-trust`에서 훅을 살펴보고 신뢰해 주세요. Grok Build 1.0.23에서는 `grok --trust inspect --json`으로도 같은 일을 할 수 있었습니다. Git이 없는 일반 폴더에서는 스킬과 규칙은 불러와도 훅은 잡히지 않을 수 있습니다. 그다음 이렇게 보내 보세요.
39
39
 
40
40
  ```text
41
41
  /litwork 외부 의존성 없이 index.html 하나로 할 일 목록을 만들어줘. 추가·완료·삭제 동작을 구현하고, 확인한 내용과 다음 할 일을 남겨줘. 브라우저를 자동으로 열지 말고 내가 확인할 순서를 알려줘.
42
42
  ```
43
43
 
44
- 만들어진 `index.html`을 직접 열어 항목을 추가하고, 완료로 표시하고, 지워 보세요. 돌려 보지 못한 검사는 미확인으로 남겨 두세요.
44
+ 그다음 `index.html`을 직접 열어 항목을 추가하고, 완료로 표시하고, 지워 보세요. 이렇게 직접 눌러 보는 것이 진짜 확인이고, 해 보지 못한 검사는 미확인으로 남겨 둡니다.
45
45
 
46
46
  ## 다음 세션으로 이어 가기
47
47
 
@@ -51,7 +51,7 @@ npm exec --yes --package "$LITGROK_PACK" -- litgrok install
51
51
  /lit-handoff 지금까지 만든 것, 확인한 것, 남은 일을 기록하고 저장 경로를 알려줘.
52
52
  ```
53
53
 
54
- 다음 세션에서는 돌려받은 경로를 Grok Build에 알려 주고, 그 문서를 읽은 뒤 현재 파일 상태부터 확인하라고 요청하세요. 인수인계 문서가 있다고 작업이 저절로 이어지지는 않습니다.
54
+ 다음 세션에서는 돌려받은 경로를 Grok Build에 알려 주고, 그 문서를 읽은 뒤 현재 파일 상태부터 확인하고 이어 가라고 요청하세요.
55
55
 
56
56
  ## 자주 쓰는 명령
57
57
 
@@ -70,13 +70,21 @@ npm exec --yes --package "$LITGROK_PACK" -- litgrok install
70
70
 
71
71
  ## 설치하면 달라지는 것
72
72
 
73
- 설치 프로그램이 스킬, 에이전트, 프로젝트 규칙, 훅을 `.grok/`에 복사합니다. [`hooks/hooks.json`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/hooks/hooks.json)에 있는 훅 등록 열한 개는 신뢰한 Git 루트에서만 동작하고, `.grok/litgrok/session-ledger/`에 이벤트 순서를 남깁니다. LitGrok이 백그라운드 작업을 예약하거나 세션이 끝난 뒤에 일을 이어 가지는 않습니다.
73
+ 설치 프로그램이 스킬, 에이전트, 프로젝트 규칙, 훅을 `.grok/`에 복사합니다. [`hooks/hooks.json`](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/hooks/hooks.json)에 있는 훅 등록 열한 개는 신뢰한 Git 루트에서만 동작하고, `.grok/litgrok/session-ledger/`에 이벤트 순서를 남깁니다. 모든 작업은 Grok 세션 안에서 돌고 백그라운드 작업은 없습니다. 세션이 끝나면 다음 세션이 이어받을 때까지 그 자리에 멈춰 있습니다.
74
74
 
75
- 원하면 `install --user --status-line`으로 사용자 범위에 상태 행을 켤 수 있습니다. `~/.grok/config.toml`에 `[ui.status_line]`을 추가하며, 파일이 이미 있으면 먼저 백업합니다.
75
+ 지금 어떤 LitGrok 스킬이 동작 중인지, 어떤 모델을 쓰는지, 컨텍스트를 얼마나 썼는지 보고 싶으면 `install --user --status-line`으로 상태 행을 켜세요. `~/.grok/config.toml`에 `[ui.status_line]`을 넣고, 파일이 이미 있으면 먼저 백업합니다.
76
76
 
77
77
  ## 안전과 제거
78
78
 
79
- 설치 프로그램은 파일을 업데이트하거나 지우기 전에 자기가 설치한 파일인지 확인하고, 사용자가 고친 파일이나 다른 곳에서 온 파일, 안전하지 않은 경로는 덮어쓰지 않습니다. `CI`, `NO_COLOR`(값이 비어 있어도), `--no-color`, `--dry-run`은 `--yes`를 붙여도 파일을 쓰지 않는 미리보기입니다. `--yes` 없이 비대화형으로 실행해도 미리보기로 끝납니다.
79
+ 설치 프로그램은 파일을 업데이트하거나 지우기 전에 자기가 설치한 파일인지 확인합니다. 직접 고친 파일이나 다른 도구가 둔 파일, 안전하지 않은 경로가 하나라도 있으면 아무 파일도 쓰기 전에 멈추고 그 파일을 알려 줍니다.
80
+
81
+ 어떤 때는 미리보기만 하고 끝납니다. 무엇을 할지 보여 준 뒤 `no files written`을 출력하고 멈추는데, `--yes`를 붙여도 다음 경우에는 그렇습니다.
82
+
83
+ - `--dry-run`: 먼저 계획만 보겠다고 한 경우
84
+ - `--no-color`를 붙였거나 환경에 `NO_COLOR`가 있는 경우(빈 값도 포함). 실제로 설치하려면 이 변수를 지우세요.
85
+ - 환경에 `CI`가 있는 경우. CI 작업은 늘 미리보기로 끝납니다.
86
+
87
+ `--yes` 없이 스크립트처럼 터미널이 연결되지 않은 곳에서 실행해도 미리보기입니다.
80
88
 
81
89
  설치할 때와 같은 범위로 제거하세요.
82
90
 
@@ -85,18 +93,18 @@ npm exec --yes --package @litfamily/litgrok@latest -- litgrok uninstall
85
93
  npm exec --yes --package @litfamily/litgrok@latest -- litgrok uninstall --user
86
94
  ```
87
95
 
88
- 설치 프로그램은 `git init`을 실행하거나 훅을 대신 신뢰하지 않고, 로그인 상태나 API 키를 쓰지 않으며, 모델도 고르지 않습니다. 패키지 테스트가 통과했다고 실제 Grok에서도 그렇게 동작한다는 뜻은 아닙니다. 저장소 루트에서 직접 연 세션으로 `/hooks`와 `grok inspect --json`을 확인하세요.
96
+ 설치 프로그램은 `git init`을 실행하거나 훅을 대신 신뢰하지 않고, 로그인이나 모델 선택도 하지 않습니다. 이런 일과 API 키는 Grok Build에서 직접 다룹니다. 패키지 테스트는 배포하는 파일을 검사합니다. 지금 세션이 실제로 무엇을 불러왔는지는 저장소 루트에서 Grok Build를 열고 `/hooks`와 `grok inspect --json`으로 확인하세요.
89
97
 
90
98
  ## 잘 안 될 때
91
99
 
92
- - **훅이 보이지 않을 때:** 훅은 신뢰한 Git 프로젝트 루트가 있어야 잡힙니다. 새 프로젝트라면 신뢰하기 전에 직접 `git init`을 실행하고, 기존 저장소라면 실제 루트에서 Grok Build를 여세요.
93
- - **파일이 쓰이지 않았을 때:** 위의 미리보기 조건 가운데 하나에 걸린 것입니다. 설치 메시지에서 파일이 실제로 쓰였는지 확인하세요.
94
- - **상태 행이 보이지 않을 때:** 상태 행은 사용자나 관리자 설정에서 옵니다. Grok은 프로젝트나 플러그인 설정에서는 이 값을 읽지 않습니다.
100
+ - **훅이 보이지 않을 때:** Grok은 신뢰한 Git 프로젝트 루트에서만 훅을 실행합니다. 새 프로젝트라면 신뢰하기 전에 직접 `git init`을 실행하고, 기존 저장소라면 실제 루트에서 Grok Build를 여세요.
101
+ - **파일이 쓰이지 않았을 때:** 출력에 `no files written`과 함께 `DRY RUN`, `NO COLOR`, `NON-INTERACTIVE` 가운데 이유가 나옵니다. 위 목록에서 해당하는 경우를 고치고 다시 설치하세요.
102
+ - **상태 행이 보이지 않을 때:** Grok은 상태 행을 프로젝트나 플러그인 설정이 아닌 사용자나 관리자 설정에서 읽으므로 `install --user --status-line`으로 켜야 합니다.
95
103
 
96
104
  ---
97
105
 
98
106
  **[GitHub에서 전체 안내, 스킬 갤러리, 문제 해결 보기 →](https://github.com/wjgoarxiv/litgrok/blob/main/README_ko-KR.md)**
99
107
 
100
- [상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/reference_ko-KR.md) · [변경 이력](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/CHANGELOG.md) · [개인정보](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/docs/privacy.md) · [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.10/LICENSE)
108
+ [상세 안내](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/docs/reference_ko-KR.md) · [변경 이력](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/CHANGELOG.md) · [개인정보](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/docs/privacy.md) · [MIT 라이선스](https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.12/LICENSE)
101
109
 
102
- 커버의 모션은 LitFamily 모션 스킬로 만든 브랜드 연출이며, 실제 Grok 작업 실행을 녹화한 영상이 아닙니다.
110
+ 커버의 모션은 LitFamily 모션 스킬로 만든 브랜드 연출입니다. 그려서 움직인 그림이라 실제 Grok 세션을 녹화한 장면은 들어 있지 않습니다.
@@ -1 +1 @@
1
- <svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="local: 1.0.10"><title>local: 1.0.10</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.10</text></g></svg>
1
+ <svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="local: 1.0.12"><title>local: 1.0.12</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.12</text></g></svg>
package/docs/reference.md CHANGED
@@ -77,7 +77,7 @@ npm exec --yes --package @litfamily/litgrok@latest -- litgrok install
77
77
  Pin a version when you need a reproducible install:
78
78
 
79
79
  ```bash
80
- npm exec --yes --package @litfamily/litgrok@1.0.10 -- litgrok install
80
+ npm exec --yes --package @litfamily/litgrok@1.0.12 -- litgrok install
81
81
  ```
82
82
 
83
83
  Preview without writing files:
@@ -77,7 +77,7 @@ npm exec --yes --package @litfamily/litgrok@latest -- litgrok install
77
77
  재현 가능한 설치는 버전을 고정합니다.
78
78
 
79
79
  ```bash
80
- npm exec --yes --package @litfamily/litgrok@1.0.10 -- litgrok install
80
+ npm exec --yes --package @litfamily/litgrok@1.0.12 -- litgrok install
81
81
  ```
82
82
 
83
83
  파일을 쓰지 않고 미리보기:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litfamily/litgrok",
3
- "version": "1.0.10",
3
+ "version": "1.0.12",
4
4
  "description": "Grok Build skills, project rules, and hooks installer.",
5
5
  "type": "module",
6
6
  "bin": {
package/plugin.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "litgrok",
3
- "version": "1.0.10",
3
+ "version": "1.0.12",
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"