@litfamily/litgrok 1.0.0

package/README_ko-KR.md

@@ -0,0 +1,228 @@
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.0/docs/assets/cover.webp" width="100%" alt="LitGrok v5 armory cover" /></p>
+
+<h1 align="center">LitGrok</h1>
+<p align="center"><strong>Keep the work lit.</strong></p>
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.0/docs/assets/litgrok-wordmark.svg" width="480" alt="LITGROK 디스플레이 타입" /></p>
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.0/docs/assets/litgrok-clay-icon.png" width="160" alt="LitGrok 클레이 마크" /></p>
+
+Grok Build에서 작은 결과물을 만들고, 확인한 내용과 다음 할 일을 프로젝트에 남기세요.
+
+[English](./README.md) · [설치](#30초-설치) · [처음 사용하기](#첫-lit-작업) · [상세 안내](./docs/reference_ko-KR.md)
+
+<p align="center">
+<a href="#30초-설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.0/docs/assets/readme/badge-version.svg" alt="1.0.0" /></a>
+<a href="./LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.0/docs/assets/readme/badge-license.svg" alt="MIT 라이선스" /></a>
+</p>
+
+<p align="center">
+<a href="./docs/reference_ko-KR.md"><img src="./docs/assets/readme/lucide-book-open.svg" width="16" alt="" /> 상세 안내</a> &nbsp; <a href="#30초-설치">설치</a> &nbsp; <a href="./docs/assets/readme/ignition-film.mp4"><img src="./docs/assets/readme/lucide-play.svg" width="16" alt="" /> Ignition</a> &nbsp; <a href="./LICENSE"><img src="./docs/assets/readme/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
+</p>
+
+> **불씨를 건네받았다. 이제, 당신의 작업에 옮길 차례다.**
+>
+> 고치고 싶은 버그 하나. 만들고 싶은 화면 하나. 끝내고 싶은 프로젝트 하나.
+>
+> 시작은 짧은 한 줄이면 됩니다. 세션이 바뀌면 어려운 건 어디까지 했는지 다시 짚는 일입니다. LIT은 목표와 계획, 확인한 결과, 다음에 할 일을 프로젝트에 남기는 작업을 안내합니다.
+>
+> **대화가 끝난 자리에서, 다음 작업이 시작되도록.**
+
+skill 34개, agent 11개, project rule 하나, hook 등록 열한 개를 제공합니다. Installer가 프로젝트에 전체 파일을 복사하고, 세션 실행과 모델 선택은 Grok Build가 담당합니다.
+
+패키지: **@litfamily/litgrok** · 버전: **1.0.0** · [MIT](./LICENSE)
+
+과학 시각화 corpus는 `.grok/vendor/scientific-visualization/`에 포함되며, 숫자 `045_scientific-visualization` 표기는 라이선스와 provenance 파일명에만 남습니다.
+
+> [!NOTE]
+> 아래 레지스트리 명령으로 scoped package를 설치합니다. 별도 체험을 위해 절대 로컬 패키지 경로를 사용할 수도 있습니다. 랜딩 표지와 배지는 npmjs에서도 보이도록 패키지에 포함됩니다.
+
+## 작은 lit 작업부터 시작하기
+
+Grok Build에서는 명시적인 `/litwork` 경로로 작은 작업을 시작합니다. 모델 실행은 호스트가 담당하고 LitGrok은 프로젝트에 skill, rule, 확인한 다음 단계를 남깁니다.
+
+| 프롬프트 또는 경로 | 효과 |
+| --- | --- |
+| `/litwork` | Grok Build의 제공된 작업 체크리스트를 시작합니다. |
+| `handoff` 또는 `/lit-handoff` | 확인한 결과와 다음 할 일을 다음 세션으로 건넵니다. |
+| `/lit-plan` | 확인 기준이 있는 계획을 작성합니다. |
+| `/start-work <승인된 계획>` | 승인한 계획을 실행합니다. |
+| `/review-work` | 변경과 근거를 검토합니다. |
+| `/litresearch` | 출처를 추적할 수 있는 범위 있는 조사를 하고 근거를 과장하지 않습니다. |
+
+## 실제 경로와 편집 이미지
+
+Grok Build에서 `/litwork`는 범위를 정한 작업 체크리스트를 시작하고, `handoff` 또는 `/lit-handoff`는 확인한 결과와 다음 단계를 건네며, `/lit-plan`은 확인 기준이 있는 계획을 남기고, `/start-work <승인된 계획>`은 그 계획을 실행하며, `/review-work`는 변경과 근거를 검토하고, `/litresearch`는 출처를 추적할 수 있는 범위 있는 조사를 합니다. 기대하는 효과는 확인 결과를 남기고 다음 세션에서 이어갈 수 있는 프로젝트 기록입니다. 호스트 제약도 분명합니다. 실행과 모델 선택은 Grok Build가 담당하고 LitGrok은 `.grok` payload를 설치합니다. Hook은 신뢰한 Git root에서만 제공되며, 일반 폴더에서는 skill과 rule만 로드되고 hook은 없을 수 있습니다. 이 이미지는 실제 호스트 동작을 증명하지 않는 정적 경로 안내입니다.
+
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.0/docs/assets/litgrok-ignition-1600.webp" width="48%" alt="LitGrok 점화 장치" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litgrok@1.0.0/docs/assets/litgrok-continuity-1600.webp" width="48%" alt="LitGrok 연속 장치" /></p>
+
+<p align="center"><a href="./docs/assets/readme/ignition-film.mp4"><img src="./docs/assets/readme/ignition-poster.png" width="720" alt="Ignition 모션 포스터" /></a></p>
+
+포스터를 선택하면 선택형 영상을 엽니다. README에서 자동 재생하지 않습니다.
+
+소스 트리의 `docs/assets/cover.svg`는 편집 가능한 저대역폭 대체 표지이며, 위 WebP는 제품 강조 표지입니다.
+
+## 30초 설치
+
+Node.js와 Grok Build를 준비한 뒤 체험할 프로젝트의 대화형 터미널에서 실행하세요. 기본 설치는 scoped package를 사용합니다.
+
+```bash
+npm exec --yes --package @litfamily/litgrok@latest -- litgrok install
+```
+
+별도 체험을 하려면 로컬 패키지의 실제 절대 경로를 변수에 넣고 두 줄을 차례로 실행하세요.
+
+```bash
+LITGROK_PACK='/absolute/path/to/the-provided-package.tgz'
+npm exec --yes --package "$LITGROK_PACK" -- litgrok install
+```
+
+기본 설치 위치는 `<project>/.grok/`입니다. 버전을 고정하려면 `--package @litfamily/litgrok@1.0.0`를 사용하세요. `--user`를 붙이면 `~/.grok/`에 설치합니다. [설치·업데이트 상세 안내](./docs/reference_ko-KR.md#설치).
+
+Project hook은 Grok Build에서 신뢰한 Git 프로젝트 루트가 있어야 발견됩니다. 일반 폴더에서도 설치된 skill과 rule은 로드될 수 있지만 hook은 0개로 남을 수 있습니다. 새 disposable project라면 사용자가 직접 `git init`을 실행한 뒤 trust를 허용하세요. 기존 저장소라면 실제 root에서 Grok Build를 여세요. Installer는 `git init`을 실행하거나 trust를 바꾸지 않습니다. 관찰된 Grok Build 1.0.13에서는 `grok --trust inspect --json`이 동작했지만 `grok --help`에는 global `--trust`가 표시되지 않았습니다. 이는 이 버전에서 확인한 동작입니다.
+
+`CI`나 `NO_COLOR`가 설정되어 있으면 값이 비어 있어도 설치는 파일을 쓰지 않는 미리보기로 끝납니다. `--no-color`와 비대화형 실행도 같습니다. 설치 메시지에서 파일이 쓰였는지 확인한 뒤 다음 단계로 넘어가세요.
+
+## 첫 lit 작업
+
+설치한 프로젝트의 Git root에서 Grok Build를 열거나 재시작합니다. `/hooks-trust`에서 project hook을 확인하고 신뢰하세요. 관찰된 Grok Build 1.0.13에서는 `grok --trust inspect --json`도 사용할 수 있지만 `--help`에는 이 global flag가 나오지 않습니다. 일반 폴더에서는 skill과 rule이 로드되어도 hook은 0개로 남을 수 있습니다. `/skills`에서 설치된 목록을, `/hooks`에서 hook 등록을 확인합니다. LitGrok은 Git root를 만들거나 trust를 바꾸지 않습니다.
+
+외부 서비스나 기존 테스트가 필요 없는 작은 작업부터 시작하세요. Grok Build에 다음을 입력합니다.
+
+```text
+/litwork 외부 의존성 없이 index.html 하나로 할 일 목록을 만들어줘. 추가·완료·삭제 동작을 구현하고, 확인한 내용과 다음 할 일을 남겨줘. 브라우저를 자동으로 열지 말고 내가 확인할 순서를 알려줘.
+```
+
+생성된 `index.html`을 직접 열어 항목 추가, 완료 표시, 삭제를 확인하세요. 파일이 생겼다는 것과 동작을 확인했다는 것은 다릅니다. 실행하지 못한 검사는 미확인으로 남기고, 오류가 있으면 실제 결과를 세션에 알려주세요.
+
+### 다음 세션으로 불씨 건네기
+
+```text
+계획하기 → 만들기 → 확인하기 → 다음 작업에 건네기
+```
+
+큰 변경이라면 `/lit-plan`으로 계획을 만들고 저장된 계획을 검토한 뒤 `/start-work <plan path>`를 호출하세요. 작업을 멈출 때는 다음처럼 요청할 수 있습니다.
+
+```text
+/lit-handoff 지금까지 만든 것, 확인한 것, 남은 일을 기록하고 저장 경로를 알려줘.
+```
+
+새 세션에서는 반환된 경로를 직접 지정해 문서를 읽고 현재 파일 상태부터 확인하도록 요청하세요. 기본 경로는 새 Git 프로젝트에서 `.handoff/HANDOFF.md`, Git이 없는 작업 폴더에서 `HANDOFF.md`입니다. 기존 루트 handoff가 있으면 그 파일을 사용합니다. [경로 선택과 인수인계 안내](./.grok/skills/lit-handoff/SKILL.md).
+
+**불씨를 남긴다는 것은 다음에 이어갈 일을 기록한다는 뜻입니다.** Skill이 현재 세션의 작업 절차를 안내합니다. LitGrok이 백그라운드 작업을 예약하거나 세션이 끝난 뒤 작업을 계속하지는 않습니다.
+
+## Grok Build 안에서 연결되는 것들
+
+Installer는 프로젝트의 `.grok/`에 파일을 놓습니다. `/litwork`는 현재 세션에서 따를 작업 절차를 안내하고, 실제 실행과 모델 선택은 Grok Build가 맡습니다. 아래는 주요 연결 관계입니다.
+
+```mermaid
+flowchart TD
+    I["litgrok install"] --> P["프로젝트 .grok/ 파일"]
+    P --> S["skills · /litwork"]
+    P --> R["rules · 프로젝트 지침"]
+    P --> H["hooks · /hooks-trust 필요"]
+    S --> G["Grok Build 세션"]
+    R --> G
+    G -->|신뢰한 hook 이벤트| H
+    H --> L["session-ledger · 이벤트 기록"]
+    G -->|작업 확인 · /lit-handoff| N["프로젝트 작업 노트와 handoff"]
+    N -.->|사용자가 경로를 전달| G
+```
+
+Hook의 `.grok/litgrok/session-ledger/`는 이벤트가 발생한 순서를 남깁니다. 작업 성공 여부는 결과물과 확인 기록으로 판단하세요. 다음 세션에서는 사용자가 handoff 경로를 전달합니다. 기록이 있다고 작업이 자동으로 재개되지는 않습니다.
+
+[작업 절차와 hook의 범위](./.grok/skills/litwork/SKILL.md) · [인수인계 경로](./.grok/skills/lit-handoff/SKILL.md) · [설치 상세](./docs/reference_ko-KR.md#설치)
+
+## 주요 경로
+
+| 필요한 작업 | Skill |
+|---|---|
+| 모호한 요청 구체화 | [`/deep-interview`](./.grok/skills/deep-interview/SKILL.md) |
+| 검증 기준이 있는 계획 작성 | [`/lit-plan`](./.grok/skills/lit-plan/SKILL.md) |
+| 승인한 계획 실행 | [`/start-work`](./.grok/skills/start-work/SKILL.md) |
+| 작은 작업의 범위와 결과 확인 | [`/litwork`](./.grok/skills/litwork/SKILL.md) |
+| 변경 내용과 근거 검토 | [`/review-work`](./.grok/skills/review-work/SKILL.md) |
+| 다음 세션을 위한 인수인계 | [`/lit-handoff`](./.grok/skills/lit-handoff/SKILL.md) |
+
+전체 skill 34개는 `/skills`에서 확인하세요. 이전 이름을 한 릴리스 동안 별칭으로 유지하는 정책은 [이름 변경과 호환성](./docs/reference_ko-KR.md#skill-이름-변경과-호환성)을 보세요. 이전 slash 경로는 보장되지 않습니다.
+
+## 안전과 제거
+
+파일을 쓰기 전에 설치 경로를 확인하세요.
+
+```bash
+npm exec --yes --package "$LITGROK_PACK" -- litgrok install --dry-run
+```
+
+Installer는 업데이트·삭제 전에 파일 소유권을 확인합니다. 사용자가 수정했거나 소유권을 확인할 수 없는 파일, 안전하지 않은 경로가 있으면 작업을 거부합니다. `CI`, `NO_COLOR`는 값이 비어 있어도 적용됩니다. `--no-color` 또는 비대화형 실행도 파일을 쓰지 않는 미리보기이며 `--yes`로 건너뛸 수 없습니다.
+
+로컬 패키지로 설치했다면 같은 프로젝트에서 같은 패키지로 제거합니다. `--user` 설치만 제거할 때는 제거 명령에도 `--user`를 붙이세요.
+
+```bash
+npm exec --yes --package "$LITGROK_PACK" -- litgrok uninstall
+```
+
+레지스트리 제거 명령:
+
+```bash
+npm exec --yes --package @litfamily/litgrok@latest -- litgrok uninstall
+npm exec --yes --package @litfamily/litgrok@latest -- litgrok uninstall --user
+```
+
+설치할 때 사용한 범위와 맞추세요. 업데이트는 `install`을 다시 실행합니다. Installer는 Git root를 만들거나 hook trust를 허용하거나 로그인 상태·API 키를 쓰거나 모델을 선택하지 않습니다. Hedge guard는 host 오류 시 fail-open으로 동작합니다. 패키지 테스트가 통과해도 live Grok 동작을 확인한 것은 아닙니다. Git root에서 현재 세션의 `/hooks`와 `grok inspect --json`을 확인하세요. [Host 경계와 검증](./docs/reference_ko-KR.md#검증).
+
+## 문서
+
+- [상세 안내](./docs/reference_ko-KR.md): 설치, hook, 터미널 출력, 패키지 검증, 출처.
+- [Skill learning loop](./docs/reference_ko-KR.md#skill-learning-loop): proposal 검토, 명시적 적용, rollback, macOS/Linux 지원. Windows의 learning-loop 명령은 지원하지 않습니다.
+- [Project rule](./.grok/rules/00-litgrok.md)과 [skill 목록](./.grok/skills/).
+- [변경 이력](./CHANGELOG.md)과 [라이선스](./LICENSE).
+
+- [기여 안내](./CONTRIBUTING.md), [보안](./SECURITY.md), [행동 규범](./CODE_OF_CONDUCT.md), [지원](./SUPPORT.md).
+- [개인정보와 로컬 데이터](./docs/privacy.md), [기존 npm 이름에서 이전](./docs/reference_ko-KR.md#npm-package-migration).
+
+## LITFAMILY
+
+![LitClaude, LitHermes, LitCodex, LitOpenCode, LitGrok을 표현한 다섯 장갑 기계](./docs/assets/litfamily-machines.png)
+
+다섯 제품을 장갑 기계로 표현한 일러스트입니다. 각 제품은 자기 호스트에서 독립적으로 동작합니다. 함께 설치하거나 서로 연결할 필요는 없습니다.
+
+## LIT 마크
+
+<p align="center"><img src="./docs/assets/readme/ascii-readme.svg" width="480" alt="LIT ASCII B 마크 — Grok" /></p>
+
+<details>
+<summary>ASCII 로고 복사</summary>
+
+```text
+                             ▄▄▄▄
+                   ▗███▌   ▗██████▖
+ ▗▄▄▄▄▄          ▗▟████▌   ▝██████▘
+ ▐█████        ▗▟██████▌    ▝▀▜█▀▘
+ ▐█████      ▗▟███████▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
+ ▐█████    ▗▟█████████████████████████ ▐█▀
+ ▐█████    ████████████████████████████▀
+ ▐█████    ██▛▘   ▄ ▄▄▄▄▖▄▄▄▄▄▄▄▄▄▄▄▄▄▖
+ ▐█████    ▀    ▄██ ████▌█████████████▌
+ ▐█████       ▄████ ████▌█████████████▌
+ ▐█████     ▄█████▛
+ ▐█████  ▗▟█████▀▘       ▄▄▄▄▄     ▗▖
+ ▐█████ ▐█████▀          █████     ▐▛▀
+ ▐█████ ▐███▀            █████
+ ▐█████ ▐█▀              █████
+ ▐█████ ▝                █████
+ ▐█████▄▄▄▄▄▄▄▖          █████
+ ▐███████████▛           █████
+ ▐██████████▀            █████
+
+
+grok
+```
+
+</details>
+
+## Ignition 모션
+
+브랜드 모션입니다. 실제 Grok 작업의 실행 녹화가 아닙니다.
+
+[![Ignition 모션 포스터](./docs/assets/readme/ignition-poster.png)](./docs/assets/readme/ignition-film.mp4)
+
+[10초 영상 · MP4](./docs/assets/readme/ignition-film.mp4) · [애니메이션 · GIF](./docs/assets/readme/ignition-readme.gif)

package/SECURITY.md

@@ -0,0 +1,11 @@
+# Security
+
+Treat ownership bypasses, unsafe path handling, unintended command execution, or disclosure of session data as security issues. Do not post credentials, real transcripts, private project paths, or a working exploit against another person's installation in public issues.
+
+Use the repository's private vulnerability reporting option if GitHub displays it. Its availability has not been verified for this release candidate. If it is absent, open a minimal issue asking the maintainers for a private reporting channel, without sensitive details; wait for that channel before sharing them. No private email or response deadline is promised here.
+
+Include the affected package version and installation scope, a minimal synthetic reproduction, expected refusal behavior, and impact. Preserve evidence locally and redact it before sharing. Test only in disposable profiles you own.
+
+LitGrok's installer rejects modified, foreign, and unsafe owned destinations. Hooks require project trust through `/hooks-trust` or `--trust`; installation does not grant it. The hedge guard is fail-open on host errors and cannot be treated as a security sandbox. Grok authentication, model execution, and provider retention are host concerns. [Privacy and local data](./docs/privacy.md) describes the package's own boundaries.
+
+Fixes are evaluated against the current development candidate. This project does not promise maintenance or backports for every historical version. Report an old-version issue with its exact version so maintainers can assess it.

package/SUPPORT.md

@@ -0,0 +1,9 @@
+# Support
+
+Start with the [operational reference](./docs/reference.md) or [한국어 안내](./docs/reference_ko-KR.md). Check the selected project/user scope and whether your terminal invocation was a no-write preview before reporting missing files.
+
+For bugs or questions, use Issues in the repository identified by `plugin.json`: [wjgoarxiv/litgrok](https://github.com/wjgoarxiv/litgrok). This is the source identity, not a claim that a future public release or support channel is already reachable. If you cannot access Issues, keep a local report until the release channel is available. No support SLA is promised.
+
+Provide package and Node versions, OS, command, expected result, actual result, and a synthetic reproduction. State whether evidence came from source tests, an installed tarball, or your authenticated Grok session. Attach only redacted excerpts. Use the security process for sensitive issues, and review [local data handling](./docs/privacy.md) before sharing logs.
+
+LitGrok does not provide Grok credentials, grant hook trust, choose models, or manage provider billing. Consult the host's own support for those concerns. Local installer success does not establish host discovery or authenticated runtime behavior.