@litfamily/litcodex 1.0.9 → 1.0.11

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-Ko-KR.md CHANGED
@@ -1,12 +1,12 @@
1
- <p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.9/readme-assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.9/readme-assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 다섯 로봇 패널이 차례로 켜지고, LitCodex 로봇의 눈과 테두리가 빛난 뒤 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/litcodex@1.0.11/readme-assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/cover-motion.webp" width="100%" alt="LitFamily 모션 커버: 다섯 로봇 패널이 차례로 켜지고, LitCodex 로봇의 눈과 테두리가 빛난 뒤 LITFAMILY와 KEEP THE WORK LIT. 문구가 밝아지는 영상" /></picture></p>
2
2
 
3
3
  <p align="center">
4
- <a href="#설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.9/readme-assets/badge-version.svg" alt="1.0.9" /></a>
5
- <a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.9/readme-assets/badge-license.svg" alt="MIT license" /></a>
4
+ <a href="#설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/badge-version.svg" alt="1.0.11" /></a>
5
+ <a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/badge-license.svg" alt="MIT license" /></a>
6
6
  </p>
7
7
 
8
8
  <p align="center">
9
- <a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/usage-Ko-KR.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.9/readme-assets/lucide-book-open.svg" width="16" alt="" /> 문서</a> &nbsp; <a href="#설치">설치</a> &nbsp; <a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/assets/readme/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.9/readme-assets/lucide-play.svg" width="16" alt="" /> Ignition</a> &nbsp; <a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.9/readme-assets/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
9
+ <a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/usage-Ko-KR.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/lucide-book-open.svg" width="16" alt="" /> 문서</a> &nbsp; <a href="#설치">설치</a> &nbsp; <a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/assets/readme/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/lucide-play.svg" width="16" alt="" /> Ignition</a> &nbsp; <a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
10
10
  </p>
11
11
 
12
12
  # LitCodex
@@ -24,13 +24,13 @@ LitCodex는 Codex CLI 플러그인입니다. 계획, 검토, 조사와 오래
24
24
  Node.js 22 이상과 Codex CLI가 필요합니다.
25
25
 
26
26
  ```sh
27
- npm exec --yes --package @litfamily/litcodex@1.0.9 -- litcodex install
27
+ npm exec --yes --package @litfamily/litcodex@1.0.11 -- litcodex install
28
28
  ```
29
29
 
30
- 설치기는 플러그인·훅·에이전트를 등록하고 `~/.codex/config.toml`에서 자신이 관리하는 항목만 갱신합니다.
31
- 설치 중에 리드 모델, 헬퍼 모델, 출력 스타일을 묻고, 새로 설치하면 리드는 `gpt-6-astra`/`xhigh`, 헬퍼는
32
- `gpt-6-luna`/`max`가 기본값입니다. 미리 보려면
33
- `npm exec --yes --package @litfamily/litcodex@1.0.9 -- litcodex --dry-run install`을 실행하고, 묻는 단계 없이
30
+ 설치기는 플러그인과 훅, 에이전트를 등록하고 `~/.codex/config.toml`에서는 자기가 관리하는 항목만 고칩니다.
31
+ 설치 중에 어떤 모델이 작업을 이끌지(리드), 어떤 모델이 거들지(헬퍼), 답변 스타일은 무엇으로 할지 묻습니다.
32
+ 새로 설치하면 리드는 `gpt-6-astra`/`xhigh`, 헬퍼는 `gpt-6-luna`/`max`로 시작합니다. 바뀔 내용을 먼저 보려면
33
+ `npm exec --yes --package @litfamily/litcodex@1.0.11 -- litcodex --dry-run install`을 실행하고, 묻는 단계 없이
34
34
  설치하려면 `install` 뒤에 `--yes`를 붙이세요.
35
35
 
36
36
  전역 명령으로 쓰려면 다음을 실행합니다.
@@ -40,19 +40,23 @@ npm install -g @litfamily/litcodex
40
40
  litcodex install
41
41
  ```
42
42
 
43
- 전역 설치는 postinstall 스크립트를 실행합니다. `CI`가 설정되지 않았으면 짧은 환영 문구를 보여 준 뒤
44
- `lit-typographic-motion`용 런타임을 `${XDG_CACHE_HOME:-~/.cache}/litcodex/motion-runtime/`에 미리 준비해
45
- 봅니다. 이 과정은 네트워크를 씁니다. 고정된 npm 패키지는 레지스트리에서, 고정된 글꼴·라이선스 파일은
46
- GitHub와 apache.org에서 받고, 브라우저는 내려받지 않습니다. 끝나지 않아도 패키지는 설치된 채로 남으며
47
- `litcodex motion-runtime install`로 다시 시도할 수 있습니다. 건너뛰려면 `--ignore-scripts`를 붙이거나
48
- `CI=1`을 설정하세요. `litcodex install`도 같은 준비 과정을 실행하며, 이를 끄는 옵션은 없습니다.
43
+ 전역으로 설치하면 `CI`가 설정되어 있지 않은 한 짧은 설치 스크립트가 환영 문구를 보여 주고, 영상 스킬
44
+ `lit-typographic-motion`이 쓸 도구를 미리 받아 둡니다. 처음 영상을 요청할 때 렌더링 도구가 이미 준비되어 있게
45
+ 하려는 것입니다. 그래서 인터넷을 조금 씁니다. 버전이 고정된 npm 패키지는 레지스트리에서, 고정된 글꼴·라이선스 파일은 GitHub와 apache.org에서
46
+ 받아 모두 `${XDG_CACHE_HOME:-~/.cache}/litcodex/motion-runtime/`에 둡니다. 브라우저는 받지 않습니다. 이 단계가
47
+ 끝나지 않아도 LitCodex 설치는 그대로 남고, 나중에 `litcodex motion-runtime install`로 다시 해 보면 됩니다.
49
48
 
50
- > 전역 설치가 없다면 `npm exec --yes --package @litfamily/litcodex@1.0.9 -- litcodex <command>` 형식을 사용하세요.
49
+ 전역 설치 때 이 스크립트를 빼려면 `--ignore-scripts`를 붙이거나 그 명령에만 `CI=1`을 설정하세요.
50
+ 다만 이렇게 빼도 내려받기가 뒤로 미뤄질 뿐입니다. `litcodex install`이 설치에 성공한 뒤 같은 도구를 준비하고,
51
+ 이 단계는 끌 수 없습니다.
52
+
53
+ > 전역 설치가 없다면 `npm exec --yes --package @litfamily/litcodex@1.0.11 -- litcodex <command>` 형식을 사용하세요.
51
54
 
52
55
  기존 설정과 떼어 놓고 써 보려면
53
56
  [격리된 체험 안내](https://github.com/wjgoarxiv/litcodex/blob/main/docs/npm-migration.md#isolated-local-trial)를
54
- 따르세요. `CODEX_HOME`만 바꿔서는 부족합니다. Windows에서도 설치기와 CLI shim은 동작하지만, POSIX가 필요한 Python
55
- 경로는 `BLOCKED_UNSUPPORTED_PYTHON_POSIX_RUNTIME`으로 멈춥니다.
57
+ 따르세요. 체험용 홈 디렉터리를 통째로 따로 만드는 방법인데, `CODEX_HOME` 하나만 바꾸면 기존 설정이 여전히
58
+ 읽힐 수 있기 때문입니다. Windows에서도 설치기와 CLI shim은 동작하고, POSIX가 필요한 Python 경로만
59
+ `BLOCKED_UNSUPPORTED_PYTHON_POSIX_RUNTIME`으로 멈춥니다.
56
60
 
57
61
  ## 첫 작업
58
62
 
@@ -62,8 +66,8 @@ GitHub와 apache.org에서 받고, 브라우저는 내려받지 않습니다.
62
66
  lit 회원가입 폼에 입력 검증을 추가해줘
63
67
  ```
64
68
 
65
- 답변은 `🔥 **LIT IGNITED · <discipline>** 🔥` 한 줄로 시작합니다. 이 표시는 요청이 제 경로로 들어갔다는
66
- 뜻일 뿐입니다. 목표는 성공 기준을 모두 통과해야 완료되고, 기록은 프로젝트의 `.litcodex/lit-loop/` 아래에 남습니다.
69
+ 답변이 `🔥 **LIT IGNITED · <discipline>** 🔥` 한 줄로 시작하면 요청이 LitCodex에 닿은 것입니다. 목표는 성공
70
+ 기준을 모두 통과해야 완료되고, 기록은 프로젝트의 `.litcodex/lit-loop/` 아래에 남습니다.
67
71
 
68
72
  직접 판단할 수 있는 첫 작업이 필요하다면 빈 폴더에서 이렇게 시작해 보세요.
69
73
 
@@ -86,8 +90,8 @@ lit 현재 폴더에 HTML 파일 하나로 할 일 목록을 만들어줘. 외
86
90
  | `review-work` | 변경과 그 근거를 검토합니다. |
87
91
  | `litresearch` | 출처를 달아 조사하고, 아직 불확실한 부분을 따로 적어 둡니다. |
88
92
 
89
- 다른 문구 없이 `handoff`만 보내면 인수인계 문서를 만듭니다. `lit-scientific-visualization`만 단독으로 입력하면
90
- 훅이 시각화 어댑터를 불러오며, Python 의존성을 설치하지는 않습니다.
93
+ 메시지 전체가 그 한 단어일 때만 동작하는 단어가 두 개 있습니다. `handoff`만 보내면 인수인계 문서를 만들고,
94
+ `lit-scientific-visualization`만 보내면 시각화 어댑터를 불러옵니다. Python 패키지는 설치하지 않습니다.
91
95
 
92
96
  ## 패키지에 들어 있는 스킬
93
97
 
@@ -97,7 +101,7 @@ lit 현재 폴더에 HTML 파일 하나로 할 일 목록을 만들어줘. 외
97
101
 
98
102
  **작업을 계획하고 실행하기**
99
103
 
100
- - `lit-loop`(`lit`): 오래 이어지는 루프 안에서 일하고, 확인하지 못한 것은 그대로 기록합니다.
104
+ - `lit-loop`(`lit`): 세션이 바뀌어도 이어지는 루프 안에서 일하고, 확인하지 못한 것은 그대로 적어 둡니다.
101
105
  - `litwork`: 처음부터 끝까지 꼼꼼한 구현이나 수정입니다. 실패하는 테스트 먼저, 그다음 실제 화면에서 증명합니다.
102
106
  - `lit-plan`: `.litcodex/plans/`에 번호 붙은 승인 계획을 만듭니다. 계획만 세웁니다.
103
107
  - Start Work(`lit start work <승인된 계획>`): 승인된 계획을 다섯 관문으로 실행합니다.
@@ -109,7 +113,7 @@ lit 현재 폴더에 HTML 파일 하나로 할 일 목록을 만들어줘. 외
109
113
 
110
114
  **검토, 조사, 지식**
111
115
 
112
- - `review-work`: 막는 힘이 있는 리뷰 다섯 갈래입니다. 하나라도 실패하면 승인되지 않습니다.
116
+ - `review-work`: 리뷰 다섯 개가 따로 돌고, 하나라도 통과하지 못하면 승인이 나지 않습니다.
113
117
  - `litresearch`: 조사를 요청할 때만 움직이며, 여러 갈래로 증거를 모아 출처와 함께 종합합니다.
114
118
  - `autoresearch`: 승인된 예산 안에서 실험을 반복합니다.
115
119
  - `autoconference`: 예산을 정해 두고 연구 회의를 엽니다.
@@ -155,45 +159,48 @@ lit 현재 폴더에 HTML 파일 하나로 할 일 목록을 만들어줘. 외
155
159
  ## 설치하면 달라지는 것
156
160
 
157
161
  Codex가 플러그인을 불러오고 훅을 실행합니다. 훅은 요청이 어떤 모드에 속하는지 가리고, 스킬은 에이전트의 작업
158
- 절차를 안내하며, 루프 CLI는 프로젝트 기록을 관리합니다. 패키지가 Codex의 native goal 도구를 직접 호출하지는
159
- 않습니다. 도구가 있으면 에이전트가 씁니다. paused 또는 blocked인 목표는 아래 복구 절차를 따르세요.
162
+ 절차를 안내하며, 루프 CLI는 프로젝트 기록을 관리합니다. Codex 목표 도구는 LitCodex가 직접 부르지 않고, 도구가
163
+ 있을 때 에이전트가 씁니다. 멈췄거나(paused) 막힌(blocked) 목표는 아래 복구 절차를 따르세요.
160
164
 
161
165
  - Codex에 플러그인·훅·에이전트가 등록되고 `~/.codex/config.toml`의 관리 항목이 갱신됩니다. 관련 없는 Codex
162
166
  설정은 그대로 둡니다. `--reconfigure` 전에는 바뀔 내용을 먼저 확인하세요.
163
- - 모델 경로는 설정값일 뿐, 그 모델을 쓸 수 있다거나 실제로 실행된다는 보장은 아닙니다.
167
+ - 고른 모델은 설정 파일에 적히는 값입니다. 그 모델을 실제로 쓸 수 있는지, 실제로 도는지는 Codex와 사용자 계정에 달려 있습니다.
164
168
  - 프로젝트마다 `.litcodex/lit-loop/` 아래에 로컬 기록이 생기며, Git과 패키지에서는 제외됩니다.
165
- - 진단 자체는 Codex 설정, 설치 상태, 플러그인 상태를 바꾸지 않습니다. 조건에 맞는 대화형 doctor 실행에서는
166
- 캐시해 둔 안내를 보여 줄 수 있고, 백그라운드 작업은 정해진 레지스트리만 조회해 `~/.litcodex/update-check.json`을
167
- 새로 고칠 뿐 패키지를 설치하지 않습니다. 이와 별개로, 조건에 맞는 대화형 관리 명령 뒤에는 업데이트 실행기가
168
- 새 전역 패키지를 설치할 수 있습니다. `LITCODEX_NO_UPDATE_CHECK=1`로 둘 다 끌 수 있고, 실패했거나
169
- `--json`·`--dry-run`·비TTY·CI·opt-out인 doctor 실행은 부수 효과가 없습니다.
169
+ - doctor 진단은 Codex 설정, 설치 상태, 플러그인 상태를 바꾸지 않고 살펴보기만 합니다. 터미널에서 직접 실행해
170
+ 성공적으로 끝난 doctor처럼 조건에 맞는 실행이면 캐시해 둔 새 버전 안내가 뜰 수 있고, 백그라운드 작업이 정해진
171
+ 레지스트리만 조회해 `~/.litcodex/update-check.json`에 적어 둡니다. 이 작업은 아무것도 설치하지 않습니다. 이와
172
+ 별개로, 조건에 맞는 대화형 관리 명령 뒤에는 업데이트 실행기가 새 전역 패키지를 설치할 수 있습니다.
173
+ `LITCODEX_NO_UPDATE_CHECK=1`을 설정하면 둘 다 꺼집니다. 실패했거나 `--json`·`--dry-run`으로 돌렸거나,
174
+ 비TTY·CI 환경이거나 이 설정으로 끈 doctor 실행은 부수 효과가 없습니다.
170
175
  - 테스트, 픽스처, 테스트 헬퍼, Vitest 설정은 저장소에만 있습니다. npm 패키지와 설치된 마켓플레이스 플러그인에는
171
176
  들어가지 않습니다.
172
177
 
173
- 선택 기능인 Jev 스킬 힌트는 기본값이 꺼짐입니다. 켜면(`LITCODEX_JEV=1`과 본인의 `TYPESAFE_API_KEY`) 조건에 맞는
174
- 프롬프트가 매번 TypeSafe(typesafe.ai)로 전송됩니다. 2,000자로 자르고 홈 경로, 이메일 주소, 토큰 형태의 문자열을
175
- 가리고, 프롬프트의 나머지 내용은 그대로 보냅니다. 파일, 도구 출력, 대화 기록은 보내지 않습니다. 켜기 전에
176
- [전체 설명](https://github.com/wjgoarxiv/litcodex/blob/main/README-Ko-KR.md#jev-스킬-힌트-선택)과
178
+ 선택 기능인 Jev 스킬 힌트는 평범한 요청에 맞는 번들 스킬을 제안해 주며, 기본값은 꺼짐입니다.
179
+ 켜면(`LITCODEX_JEV=1`과 본인의 `TYPESAFE_API_KEY`) 조건에 맞는 프롬프트가 매번 TypeSafe(typesafe.ai)로 갑니다.
180
+ 2,000자로 자르고 홈 경로, 이메일 주소, 토큰 형태의 문자열을 가린 뒤 나머지는 그대로 보냅니다. 파일, 도구 출력,
181
+ 대화 기록은 보내지 않습니다. 켜기 전에
182
+ [전체 설명](https://github.com/wjgoarxiv/litcodex/blob/main/README-Ko-KR.md#jev-스킬-힌트-선택)(각 상태가 화면에서 어떻게 보이는지도 나옵니다)과
177
183
  [개인정보 안내](https://github.com/wjgoarxiv/litcodex/blob/main/docs/privacy.md#optional-jev-skill-hint)를 읽어 주세요.
178
184
 
179
185
  ## 확인, 문제 해결, 제거
180
186
 
181
187
  ```sh
182
- npm exec --yes --package @litfamily/litcodex@1.0.9 -- litcodex doctor
188
+ npm exec --yes --package @litfamily/litcodex@1.0.11 -- litcodex doctor
183
189
  ```
184
190
 
185
191
  `litcodex doctor`는 등록·훅·설정·호스트 기능을, `litcodex loop doctor`는 현재 프로젝트의 루프 상태를 확인합니다.
186
- 검사를 통과해도 인증된 모델 작업까지 확인한 것은 아닙니다.
192
+ 둘 다 설치 상태를 보는 검사이고, 로그인한 모델 작업이 실제로 도는지는 작은 작업을 하나 맡겨 보면 알 수 있습니다.
187
193
 
188
194
  - **`lit`을 입력해도 반응이 없다면.** `litcodex doctor`를 실행하고 Codex에서 훅을 승인했는지 확인하세요.
189
195
  - **명령을 찾지 못한다면.** 위의 `npm exec` 형식을 쓰거나, npm 전역 bin 경로를 `PATH`에 넣으세요.
190
- - **native goal이 paused 또는 blocked라면.** `/goal resume`으로 재개하고 활성 상태인지 확인한 뒤
196
+ - **Codex 목표가 멈췄거나(paused) 막혔다면(blocked).** `/goal resume`으로 재개하고 활성 상태인지 확인한 뒤
191
197
  `litcodex loop run --retry-failed`로 다시 시도하세요. 미완료 목표는 지우지 말고 남겨 두세요.
192
- - **출력 없이 pane이 닫힌다면.** 열린 터미널에서 도움말, 설치, doctor를 하나씩 실행해 각 종료 코드를 남기고
198
+ - **아무 출력 없이 창(pane)이 닫힌다면.** 어느 단계가 문제인지부터 찾습니다. 열린 터미널에서 도움말, 설치,
199
+ doctor를 하나씩 실행해 각 종료 코드를 적어 두고
193
200
  [문제 해결](https://github.com/wjgoarxiv/litcodex/blob/main/README-Ko-KR.md#문제-해결)을 참고하세요.
194
201
 
195
202
  ```sh
196
- npm exec --yes --package @litfamily/litcodex@1.0.9 -- litcodex uninstall
203
+ npm exec --yes --package @litfamily/litcodex@1.0.11 -- litcodex uninstall
197
204
  ```
198
205
 
199
206
  플러그인과 LitCodex가 관리하는 설정을 지우고, 관련 없는 설정은 그대로 둡니다.
package/README.md CHANGED
@@ -1,12 +1,12 @@
1
- <p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.9/readme-assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.9/readme-assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: five armored robots power on one by one, the LitCodex 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/litcodex@1.0.11/readme-assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: five armored robots power on one by one, the LitCodex robot wakes with glowing eyes and a lit frame, then LITFAMILY and KEEP THE WORK LIT. light up." /></picture></p>
2
2
 
3
3
  <p align="center">
4
- <a href="#install"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.9/readme-assets/badge-version.svg" alt="1.0.9" /></a>
5
- <a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.9/readme-assets/badge-license.svg" alt="MIT license" /></a>
4
+ <a href="#install"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/badge-version.svg" alt="1.0.11" /></a>
5
+ <a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/badge-license.svg" alt="MIT license" /></a>
6
6
  </p>
7
7
 
8
8
  <p align="center">
9
- <a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/usage.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.9/readme-assets/lucide-book-open.svg" width="16" alt="" /> Docs</a> &nbsp; <a href="#install">Install</a> &nbsp; <a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/assets/readme/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.9/readme-assets/lucide-play.svg" width="16" alt="" /> Ignition</a> &nbsp; <a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.9/readme-assets/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
9
+ <a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/usage.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/lucide-book-open.svg" width="16" alt="" /> Docs</a> &nbsp; <a href="#install">Install</a> &nbsp; <a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/assets/readme/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/lucide-play.svg" width="16" alt="" /> Ignition</a> &nbsp; <a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.11/readme-assets/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
10
10
  </p>
11
11
 
12
12
  # LitCodex
@@ -24,14 +24,15 @@ the results stay in your project, where a later session can pick them up.
24
24
  You need Node.js 22 or later and Codex CLI.
25
25
 
26
26
  ```sh
27
- npm exec --yes --package @litfamily/litcodex@1.0.9 -- litcodex install
27
+ npm exec --yes --package @litfamily/litcodex@1.0.11 -- litcodex install
28
28
  ```
29
29
 
30
- The installer registers the plugin, hooks and agents, and updates the keys it manages in
31
- `~/.codex/config.toml`. It asks for a lead model, a helper model and an output style; fresh installs default
32
- to `gpt-6-astra` at `xhigh` for the lead and `gpt-6-luna` at `max` for helpers. To preview first, run
33
- `npm exec --yes --package @litfamily/litcodex@1.0.9 -- litcodex --dry-run install`; for an unattended setup,
34
- add `--yes` after `install`.
30
+ The installer registers the plugin, its hooks and its agents, and changes only the keys it manages in
31
+ `~/.codex/config.toml`. It asks which model leads, which model helps, and which output style you like. A
32
+ fresh install starts with `gpt-6-astra` at `xhigh` for the lead and `gpt-6-luna` at `max` for helpers. To
33
+ see the changes before they happen, run
34
+ `npm exec --yes --package @litfamily/litcodex@1.0.11 -- litcodex --dry-run install`. To install without
35
+ any questions, add `--yes` after `install`.
35
36
 
36
37
  For a global command:
37
38
 
@@ -40,19 +41,24 @@ npm install -g @litfamily/litcodex
40
41
  litcodex install
41
42
  ```
42
43
 
43
- A global install runs a postinstall script. Unless `CI` is set, it prints a short welcome and tries to
44
- pre-warm the runtime for `lit-typographic-motion` in `${XDG_CACHE_HOME:-~/.cache}/litcodex/motion-runtime/`.
45
- That step uses the network: pinned npm packages come from your registry, pinned font and license files from
46
- GitHub and apache.org, and no browser is downloaded. If it does not finish, the package stays installed and
47
- you can retry with `litcodex motion-runtime install`. Add `--ignore-scripts` or set `CI=1` to leave it out.
48
- `litcodex install` runs the same pre-warm and has no switch to turn it off.
44
+ After a global install, unless `CI` is set, a short setup script prints a welcome and gets the video skill,
45
+ `lit-typographic-motion`, ready ahead of time, so its rendering tools are in place before your first
46
+ video. That means a few downloads: pinned npm packages from your registry and pinned font and license
47
+ files from GitHub and apache.org, all into `${XDG_CACHE_HOME:-~/.cache}/litcodex/motion-runtime/`. No
48
+ browser is downloaded. If the step does not finish, LitCodex is still installed; run
49
+ `litcodex motion-runtime install` later to try again.
49
50
 
50
- > Without a global install, use `npm exec --yes --package @litfamily/litcodex@1.0.9 -- litcodex <command>`.
51
+ To keep the script out of the global install, add `--ignore-scripts` or set `CI=1` for that command.
52
+ That only postpones the downloads: `litcodex install` prepares
53
+ the same tools after a successful install, with no switch to turn it off.
54
+
55
+ > Without a global install, use `npm exec --yes --package @litfamily/litcodex@1.0.11 -- litcodex <command>`.
51
56
 
52
57
  To try LitCodex apart from your existing settings, follow the
53
- [isolated trial guide](https://github.com/wjgoarxiv/litcodex/blob/main/docs/npm-migration.md#isolated-local-trial);
54
- changing only `CODEX_HOME` is not enough. On Windows the installer and CLI shims work, but Python routes that
55
- need POSIX stop with `BLOCKED_UNSUPPORTED_PYTHON_POSIX_RUNTIME`.
58
+ [isolated trial guide](https://github.com/wjgoarxiv/litcodex/blob/main/docs/npm-migration.md#isolated-local-trial).
59
+ It gives the trial a whole home of its own, since changing only `CODEX_HOME` still lets your existing
60
+ settings be found. On Windows the installer and CLI shims work; Python routes that need POSIX stop there
61
+ with `BLOCKED_UNSUPPORTED_PYTHON_POSIX_RUNTIME`.
56
62
 
57
63
  ## First task
58
64
 
@@ -62,9 +68,9 @@ Open Codex in your project, approve the LitCodex hooks in the startup review, an
62
68
  lit add input validation to the signup form
63
69
  ```
64
70
 
65
- The reply opens with `🔥 **LIT IGNITED · <discipline>** 🔥`. That mark only means the request was routed.
66
- A goal is complete when every one of its success criteria passes, and the records live under
67
- `.litcodex/lit-loop/` in your project.
71
+ The reply opens with `🔥 **LIT IGNITED · <discipline>** 🔥`, which tells you the request reached
72
+ LitCodex. A goal is complete once every one of its success criteria passes, and the records live
73
+ under `.litcodex/lit-loop/` in your project.
68
74
 
69
75
  For a first run you can judge yourself, try this in an empty folder:
70
76
 
@@ -87,8 +93,9 @@ was recorded, and sending `handoff` on its own before you leave gives the next s
87
93
  | `review-work` | Reviews the change and its evidence. |
88
94
  | `litresearch` | Researches with sources and keeps track of what is still uncertain. |
89
95
 
90
- Send exact bare `handoff` as its own message to write a continuation packet. The exact bare
91
- `lit-scientific-visualization` hook route loads the plotting adapter; it does not install Python dependencies.
96
+ Two words work only when they are the whole message. Send exact bare `handoff` to write a continuation
97
+ packet. The exact bare `lit-scientific-visualization` hook route loads the plotting adapter;
98
+ it does not install Python dependencies.
92
99
 
93
100
  ## What else is in the package
94
101
 
@@ -98,8 +105,8 @@ You can pick these skills in the Codex skill picker or mention one by scoped nam
98
105
 
99
106
  **Planning and running work**
100
107
 
101
- - `lit-loop` (`lit`): works inside the durable loop and records what it could not verify.
102
- - `litwork`: a careful end-to-end build or fix, failing test first, then proof on the real surface.
108
+ - `lit-loop` (`lit`): works inside a loop that survives across sessions, and writes down what it could not verify.
109
+ - `litwork`: a careful build or fix from start to finish, failing test first, then proof where the thing actually runs.
103
110
  - `lit-plan`: an approved plan with numbered rows in `.litcodex/plans/`; planning only.
104
111
  - Start Work (`lit start work <approved-plan>`): runs an approved plan through five gates.
105
112
  - `litgoal`: binds one goal with observable criteria to the loop.
@@ -110,7 +117,7 @@ You can pick these skills in the Codex skill picker or mention one by scoped nam
110
117
 
111
118
  **Review, research and knowledge**
112
119
 
113
- - `review-work`: five blocking reviews; one failure blocks approval.
120
+ - `review-work`: five separate reviews, and any one of them can hold back approval.
114
121
  - `litresearch`: parallel evidence gathering and a cited synthesis, only when you ask for research.
115
122
  - `autoresearch` and `autoconference`: an approved, budgeted experiment loop, and a budgeted research conference.
116
123
  - `lit-fetch`: reads a public page with URL, DNS and text-safety checks when ordinary retrieval falls short.
@@ -156,48 +163,52 @@ In ten one-line A/B tasks against plain Codex, the final verdicts for LitCodex w
156
163
  ## What it changes
157
164
 
158
165
  Codex hosts the plugin and runs its hooks. The hooks work out which mode a request belongs to, the skills
159
- guide the agent, and the loop CLI keeps the project records. The package never calls Codex's native goal
160
- tools itself; the agent uses them when they are available, and a paused or blocked goal needs the recovery
161
- step below.
166
+ guide the agent, and the loop CLI keeps the project records. LitCodex never calls Codex's goal tools
167
+ itself; the agent uses them when they are there. A paused or blocked goal needs the recovery step below.
162
168
 
163
169
  - Codex gets the plugin, hooks and agents, plus the managed keys in `~/.codex/config.toml`. Your unrelated
164
170
  Codex settings stay as they are. Look at the planned changes before you use `--reconfigure`.
165
- - A model route is a configuration choice. It does not guarantee access to that model or that it runs.
171
+ - The model you pick is a setting in your config. Whether it is open to you, and whether it actually
172
+ runs, is up to Codex and your account.
166
173
  - Each project gets local records under `.litcodex/lit-loop/`, kept out of Git and packages.
167
174
  - The doctor diagnostic core never modifies Codex config, install state or plugin state. An eligible
168
- interactive doctor run may show a cached advisory notice. Its detached worker performs a fixed registry
169
- refresh at `~/.litcodex/update-check.json` and never installs packages. A separate foreground updater can
170
- install a newer global package after eligible interactive management commands; set
171
- `LITCODEX_NO_UPDATE_CHECK=1` to turn off both. Failed, `--json`, `--dry-run`, non-TTY, CI and opt-out doctor
172
- runs stay side-effect-free.
175
+ interactive doctor run (a successful one you start by hand) may show a cached advisory notice about a
176
+ newer version; a detached worker keeps it fresh with a fixed registry refresh saved at
177
+ `~/.litcodex/update-check.json`, and installs nothing. A separate foreground updater can install a newer
178
+ global package after an eligible interactive management command. Set `LITCODEX_NO_UPDATE_CHECK=1` to
179
+ turn off both. A doctor run that failed, or ran with `--json`, `--dry-run`, in a non-TTY or CI shell, or
180
+ with the opt-out set, stays side-effect-free.
173
181
  - Tests, fixtures, test helpers and the Vitest configuration live only in the repository. Neither the npm
174
182
  package nor the installed marketplace plugin includes them.
175
183
 
176
- The optional Jev skill hint is off by default. Turning it on (`LITCODEX_JEV=1` plus your own
177
- `TYPESAFE_API_KEY`) sends each eligible prompt to TypeSafe (typesafe.ai), cut to 2,000 characters with home
178
- paths, email addresses and token-shaped strings redacted; the rest of the prompt is sent as written, but no files, tool output or history.
179
- Read [the full description](https://github.com/wjgoarxiv/litcodex#jev-skill-hint-optional) and the
184
+ The optional Jev skill hint suggests a bundled skill for a plain prompt, and it is off by default.
185
+ Turning it on (`LITCODEX_JEV=1` plus your own `TYPESAFE_API_KEY`) sends each eligible prompt to TypeSafe
186
+ (typesafe.ai). The prompt is cut to 2,000 characters and home paths, email addresses and token-shaped
187
+ strings are redacted; the rest of it is sent as written. Nothing else from the session goes with it:
188
+ no files, tool output or history.
189
+ Read [the full description](https://github.com/wjgoarxiv/litcodex#jev-skill-hint-optional), which shows what
190
+ appears on screen in each state, and the
180
191
  [privacy notes](https://github.com/wjgoarxiv/litcodex/blob/main/docs/privacy.md#optional-jev-skill-hint)
181
192
  before you turn it on.
182
193
 
183
194
  ## Check, fix, remove
184
195
 
185
196
  ```sh
186
- npm exec --yes --package @litfamily/litcodex@1.0.9 -- litcodex doctor
197
+ npm exec --yes --package @litfamily/litcodex@1.0.11 -- litcodex doctor
187
198
  ```
188
199
 
189
200
  `litcodex doctor` checks registration, hooks, config and host capabilities; `litcodex loop doctor` checks the
190
- current project's loop state. A clean check does not prove that authenticated model work will run.
201
+ current project's loop state. Both look at the setup; a small real task shows whether signed-in model work runs.
191
202
 
192
203
  - **`lit` does nothing.** Run `litcodex doctor` and check that the hooks are approved in Codex.
193
204
  - **The command is missing.** Use the `npm exec` form above, or put npm's global bin directory on your `PATH`.
194
205
  - **A native goal is paused or blocked.** Run `/goal resume`, confirm the goal is active, then retry with
195
206
  `litcodex loop run --retry-failed`. Keep the unfinished goal.
196
- - **The pane closes before any output.** Run help, install and doctor one at a time in an open terminal,
197
- keep each exit status, and see [troubleshooting](https://github.com/wjgoarxiv/litcodex#troubleshooting).
207
+ - **The pane closes before any output.** Find the failing step: run help, install and doctor one at a
208
+ time in an open terminal, note each exit status, and see [troubleshooting](https://github.com/wjgoarxiv/litcodex#troubleshooting).
198
209
 
199
210
  ```sh
200
- npm exec --yes --package @litfamily/litcodex@1.0.9 -- litcodex uninstall
211
+ npm exec --yes --package @litfamily/litcodex@1.0.11 -- litcodex uninstall
201
212
  ```
202
213
 
203
214
  This removes the plugin and the config LitCodex manages, and leaves your other settings alone.
@@ -8,6 +8,7 @@ import { createRequire } from "node:module";
8
8
  import { homedir } from "node:os";
9
9
  import { join } from "node:path";
10
10
  import { EXPLICIT_GPT56_SOL_MODEL, GPT56_MODELS } from "../config-migration/gpt56-policy.js";
11
+ import { isNewer } from "../update-check.js";
11
12
  import { inspectAgentRouting, routingReport } from "./agent-routing.js";
12
13
  import { detectAuthMode } from "./auth-mode.js";
13
14
  import { probeBundledSkills } from "./bundled-skills.js";
@@ -193,8 +194,22 @@ function readAutoUpdateReport(env) {
193
194
  try {
194
195
  const parsed = JSON.parse(readFileSync(receiptPath, "utf8"));
195
196
  if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
196
- const status = parsed["status"];
197
+ const fields = parsed;
198
+ const status = fields["status"];
197
199
  if (typeof status === "string") {
200
+ const target = fields["latestVersion"];
201
+ // A failed update whose target the installed package has since reached (or passed) is history:
202
+ // a later install finished the job, so the old receipt no longer describes this machine.
203
+ if (status === "unknown-state" &&
204
+ typeof target === "string" &&
205
+ (target === PACKAGE_VERSION || isNewer(PACKAGE_VERSION, target))) {
206
+ return {
207
+ enabled,
208
+ status: "resolved",
209
+ receiptPath,
210
+ detail: `an earlier update to ${target} did not finish, and ${PACKAGE_VERSION} is installed now`,
211
+ };
212
+ }
198
213
  return {
199
214
  enabled,
200
215
  status,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "litcodex",
3
- "version": "1.0.9",
3
+ "version": "1.0.11",
4
4
  "description": "LitCodex Codex plugin: the lit-loop activation, durable loop runtime, and local review-gated knowledge.",
5
5
  "license": "MIT",
6
6
  "keywords": [
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/auto-update",
3
- "version": "1.0.9",
3
+ "version": "1.0.11",
4
4
  "description": "LitCodex foreground update barrier for the SessionStart and management lifecycles.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/comment-checker",
3
- "version": "1.0.9",
3
+ "version": "1.0.11",
4
4
  "description": "LitCodex Comment-Checker hook: flags low-value / AI-slop comments introduced by edits.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/git-bash",
3
- "version": "1.0.9",
3
+ "version": "1.0.11",
4
4
  "description": "LitCodex Git-Bash hook: reminds Windows sessions to prefer the git_bash MCP before the built-in shell.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/lit-loop",
3
- "version": "1.0.9",
3
+ "version": "1.0.11",
4
4
  "description": "LitCodex Lit-Loop runtime: durable repo-native multi-goal orchestration with embedded success criteria and observable evidence audit.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/lsp",
3
- "version": "1.0.9",
3
+ "version": "1.0.11",
4
4
  "description": "LitCodex LSP hook (inert placeholder): post-edit diagnostics + cache reset, no-op until an LSP daemon is provided.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/rules",
3
- "version": "1.0.9",
3
+ "version": "1.0.11",
4
4
  "description": "LitCodex rules: injects project rule files (AGENTS.md etc.) into model context through lifecycle hooks.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/start-work-continuation",
3
- "version": "1.0.9",
3
+ "version": "1.0.11",
4
4
  "description": "LitCodex Start-Work continuation hook: resumes in-flight start-work state on root Stop.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/telemetry",
3
- "version": "1.0.9",
3
+ "version": "1.0.11",
4
4
  "description": "LitCodex telemetry: a deliberately inert, local-only SessionStart hook (NO network, NO data collection).",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/wikify-knowledge",
3
- "version": "1.0.9",
3
+ "version": "1.0.11",
4
4
  "description": "Local review-gated knowledge records for the LitCodex Wikify surface.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/lit-loop",
3
- "version": "1.0.9",
3
+ "version": "1.0.11",
4
4
  "description": "LitCodex Lit-Loop runtime: durable repo-native multi-goal orchestration with embedded success criteria and observable evidence audit.",
5
5
  "type": "module",
6
6
  "private": true,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litfamily/litcodex",
3
- "version": "1.0.9",
3
+ "version": "1.0.11",
4
4
  "description": "Codex loop harness installer. Run `npm exec --package @litfamily/litcodex -- litcodex install` to set up the LitCodex Codex platform: the bare `lit` hook and the durable lit-loop runtime.",
5
5
  "keywords": [
6
6
  "codex",
@@ -44,7 +44,7 @@
44
44
  "readme-assets"
45
45
  ],
46
46
  "dependencies": {
47
- "@litcodex/lit-loop": "1.0.9"
47
+ "@litcodex/lit-loop": "1.0.11"
48
48
  },
49
49
  "bundledDependencies": [
50
50
  "@litcodex/lit-loop"
@@ -1 +1 @@
1
- <svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.9"><title>release: 1.0.9</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.9</text></g></svg>
1
+ <svg xmlns="http://www.w3.org/2000/svg" width="146" height="20" role="img" aria-label="release: 1.0.11"><title>release: 1.0.11</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.11</text></g></svg>