@litfamily/litcodex 1.0.18 → 1.0.19

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.
Files changed (44) hide show
  1. package/README-Ko-KR.md +46 -147
  2. package/README.md +46 -150
  3. package/dist/auto-update.d.ts +2 -1
  4. package/dist/auto-update.js +2 -1
  5. package/dist/cli.d.ts +1 -1
  6. package/dist/cli.js +85 -5
  7. package/dist/config-migration/multi-agent-v2-guard.js +10 -21
  8. package/dist/config-migration/root-settings.js +30 -31
  9. package/dist/config-migration/toml-lines.d.ts +12 -0
  10. package/dist/config-migration/toml-lines.js +113 -0
  11. package/dist/config-migration/toml-shape.js +8 -15
  12. package/dist/install/doctor-render.js +19 -0
  13. package/dist/install/doctor-tui.d.ts +7 -0
  14. package/dist/install/doctor-tui.js +65 -0
  15. package/dist/install/doctor.js +2 -0
  16. package/dist/install/generated-skill-payload-hashes.d.ts +1 -1
  17. package/dist/install/generated-skill-payload-hashes.js +1 -1
  18. package/dist/install/index.d.ts +6 -1
  19. package/dist/install/index.js +16 -2
  20. package/dist/install/office-runtime.d.ts +1 -0
  21. package/dist/install/office-runtime.js +2 -2
  22. package/dist/install/types.d.ts +10 -0
  23. package/dist/install/uninstall.d.ts +2 -0
  24. package/dist/install/uninstall.js +12 -1
  25. package/marketplace/plugins/litcodex/.codex-plugin/plugin.json +1 -1
  26. package/marketplace/plugins/litcodex/components/auto-update/dist/auto-update.d.ts +16 -1
  27. package/marketplace/plugins/litcodex/components/auto-update/dist/auto-update.js +99 -13
  28. package/marketplace/plugins/litcodex/components/auto-update/package.json +1 -1
  29. package/marketplace/plugins/litcodex/components/comment-checker/package.json +1 -1
  30. package/marketplace/plugins/litcodex/components/git-bash/package.json +1 -1
  31. package/marketplace/plugins/litcodex/components/lit-loop/package.json +1 -1
  32. package/marketplace/plugins/litcodex/components/lsp/package.json +1 -1
  33. package/marketplace/plugins/litcodex/components/rules/dist/deliverable-hedge-guard.d.ts +6 -0
  34. package/marketplace/plugins/litcodex/components/rules/dist/deliverable-hedge-guard.js +10 -29
  35. package/marketplace/plugins/litcodex/components/rules/package.json +1 -1
  36. package/marketplace/plugins/litcodex/components/start-work-continuation/package.json +1 -1
  37. package/marketplace/plugins/litcodex/components/telemetry/package.json +1 -1
  38. package/marketplace/plugins/litcodex/components/wikify-knowledge/package.json +1 -1
  39. package/marketplace/plugins/litcodex/hooks/hooks.json +1 -1
  40. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/validate_pptx.py +3 -3
  41. package/node_modules/@litcodex/lit-loop/README.md +1 -1
  42. package/node_modules/@litcodex/lit-loop/package.json +1 -1
  43. package/package.json +12 -4
  44. package/readme-assets/badge-version.svg +1 -1
package/README-Ko-KR.md CHANGED
@@ -1,62 +1,45 @@
1
- <p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.18/readme-assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.18/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.19/readme-assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.19/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.18/readme-assets/badge-version.svg" alt="1.0.18" /></a>
5
- <a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.18/readme-assets/badge-license.svg" alt="MIT license" /></a>
4
+ <a href="#설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.19/readme-assets/badge-version.svg" alt="1.0.19" /></a>
5
+ <a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.19/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.18/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.18/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.18/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.19/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.19/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.19/readme-assets/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
10
10
  </p>
11
11
 
12
12
  # LitCodex
13
13
 
14
14
  **Keep the work lit.**
15
15
 
16
- LitCodex는 Codex CLI 플러그인입니다. 계획, 검토, 조사와 오래 이어지는 실행 루프를 더해서, 한 번 시작한
17
- 작업이 대화가 끝난 뒤에도 이어지게 합니다. 요청에 `lit`을 붙이면 목표와 확인 기준, 결과가 프로젝트에 남고,
18
- 다음 세션에 그 기록을 읽게 해서 이어갈 수 있습니다.
16
+ 요청을 확인 기준이 붙은 목표로 바꾸고, 그 증거를 프로젝트에 남기고, 끝내지 못한 일은 다음 세션에 넘겨 주는
17
+ Codex CLI 플러그인입니다.
19
18
 
20
- **[전체 안내와 스킬 갤러리는 GitHub에서](https://github.com/wjgoarxiv/litcodex/blob/main/README-Ko-KR.md)** · [English](https://github.com/wjgoarxiv/litcodex#readme)
19
+ **[GitHub에서 전체 안내 보기](https://github.com/wjgoarxiv/litcodex/blob/main/README-Ko-KR.md)** · [English](https://github.com/wjgoarxiv/litcodex#readme)
21
20
 
22
21
  ## 설치
23
22
 
24
23
  Node.js 22 이상과 Codex CLI가 필요합니다.
25
24
 
26
25
  ```sh
27
- npm exec --yes --package @litfamily/litcodex@1.0.18 -- litcodex install
26
+ npm exec --yes --package @litfamily/litcodex@1.0.19 -- litcodex install
28
27
  ```
29
28
 
30
- 설치기는 플러그인과 훅, 에이전트를 등록하고 `~/.codex/config.toml`에서는 자기가 관리하는 항목만 고칩니다.
31
- 설치 중에 어떤 모델이 작업을 이끌지(리드), 어떤 모델이 거들지(헬퍼), 답변 스타일은 무엇으로 할지 묻습니다.
32
- 새로 설치하면 리드는 `gpt-6-astra`/`xhigh`, 헬퍼는 `gpt-6-luna`/`max`로 시작합니다. 바뀔 내용을 먼저 보려면
33
- `npm exec --yes --package @litfamily/litcodex@1.0.18 -- litcodex --dry-run install`을 실행하고, 묻는 단계 없이
29
+ 설치기는 어떤 모델이 이끌지, 어떤 모델이 거들지, 답변 스타일은 무엇으로 할지 묻고, 쓰려는 내용을 먼저 보여 준 뒤
30
+ `~/.codex/config.toml`에서 자기가 관리하는 항목만 고칩니다. 계획만 먼저 보려면
31
+ `npm exec --yes --package @litfamily/litcodex@1.0.19 -- litcodex --dry-run install`을 실행하고, 묻는 단계 없이
34
32
  설치하려면 `install` 뒤에 `--yes`를 붙이세요.
35
33
 
36
- 전역 명령으로 쓰려면 다음을 실행합니다.
37
-
38
34
  ```sh
39
35
  npm install -g @litfamily/litcodex
40
36
  litcodex install
41
37
  ```
42
38
 
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`로 다시 해 보면 됩니다.
48
-
49
- 전역 설치 때 이 스크립트를 빼려면 `--ignore-scripts`를 붙이거나 그 명령에만 `CI=1`을 설정하세요.
50
- 다만 이렇게 빼도 내려받기가 뒤로 미뤄질 뿐입니다. `litcodex install`이 설치에 성공한 뒤 같은 도구를 준비하고,
51
- 이 단계는 끌 수 없습니다.
52
-
53
- > 전역 설치가 없다면 `npm exec --yes --package @litfamily/litcodex@1.0.18 -- litcodex <command>` 형식을 사용하세요.
39
+ 전역으로 설치하면 영상 스킬이 쓸 도구를 미리 준비하느라 버전이 고정된 파일 몇 개를 내려받습니다. 무엇을 받는지와
40
+ 건너뛰는 방법은 [설치 안내](https://github.com/wjgoarxiv/litcodex/blob/main/docs/install-Ko-KR.md#전역-명령으로-쓰기)에 있습니다.
54
41
 
55
- 기존 설정과 떼어 놓고 써 보려면
56
- [격리된 체험 안내](https://github.com/wjgoarxiv/litcodex/blob/main/docs/npm-migration.md#isolated-local-trial)를
57
- 따르세요. 체험용 홈 디렉터리를 통째로 따로 만드는 방법인데, `CODEX_HOME` 하나만 바꾸면 기존 설정이 여전히
58
- 읽힐 수 있기 때문입니다. Windows에서도 설치기와 CLI shim은 동작하고, POSIX가 필요한 Python 경로만
59
- `BLOCKED_UNSUPPORTED_PYTHON_POSIX_RUNTIME`으로 멈춥니다.
42
+ > 전역 설치가 없다면 `npm exec --yes --package @litfamily/litcodex@1.0.19 -- litcodex <command>` 형식을 사용하세요.
60
43
 
61
44
  ## 첫 작업
62
45
 
@@ -66,141 +49,57 @@ litcodex install
66
49
  lit 회원가입 폼에 입력 검증을 추가해줘
67
50
  ```
68
51
 
69
- 답변이 `🔥 **LIT IGNITED · <discipline>** 🔥` 한 줄로 시작하면 요청이 LitCodex에 닿은 것입니다. 목표는 성공
70
- 기준을 모두 통과해야 완료되고, 기록은 프로젝트의 `.litcodex/lit-loop/` 아래에 남습니다.
52
+ 답변이 `🔥 **LIT IGNITED · <discipline>** 🔥` 한 줄로 시작합니다. 목표는 모든 기준에 통과 증거가 있어야 완료되고,
53
+ 기록은 프로젝트의 `.litcodex/lit-loop/` 아래에 남습니다. `lit recap`으로 다시 읽을 수 있습니다. 세션을 마치기 전에
54
+ `handoff`만 따로 보내면 다음 세션이 시작할 인수인계 문서가 생깁니다. `lit-scientific-visualization`만 보내면 시각화
55
+ 어댑터를 불러오며, Python 패키지는 설치하지 않습니다.
71
56
 
72
- 직접 판단할 수 있는 첫 작업이 필요하다면 빈 폴더에서 이렇게 시작해 보세요.
57
+ ## 스킬
73
58
 
74
- ```text
75
- lit 현재 폴더에 HTML 파일 하나로 할 일 목록을 만들어줘. 외부 의존성은 설치하지 마.
76
- 할 일 추가와 완료 처리를 확인하고, 확인하지 못한 부분은 따로 남겨줘.
77
- ```
59
+ 모든 스킬은 Codex skill picker에서 고르거나 `$litcodex:lit-humanizer`, `$litcodex:lit-fetch`,
60
+ `$litcodex:lit-handoff`, `$litcodex:lit-scientific-visualization`처럼 이름으로 부를 수 있습니다. 스킬마다 그림은
61
+ [스킬 안내](https://github.com/wjgoarxiv/litcodex/blob/main/docs/skills-Ko-KR.md)에 있습니다.
78
62
 
79
- 끝나면 결과물, 실제로 돌린 확인, 아직 남은 일을 살펴보세요. `lit recap`은 기록된 상태를 다시 읽어 주고,
80
- 세션을 마치기 전에 `handoff`만 따로 보내 두면 다음 세션이 거기서 시작할 수 있습니다.
81
-
82
- ## 자주 쓰는 경로
83
-
84
- | 입력 | 하는 일 |
85
- | --- | --- |
86
- | `lit` | 프로젝트에 목표와 확인 기준을 남기며 범위가 정해진 작업을 시작합니다. |
87
- | `handoff` 또는 `/lit-handoff` | 확인한 결과와 다음 할 일을 다음 세션으로 넘깁니다. |
88
- | `lit-plan` | 무엇이든 고치기 전에 계획과 성공 기준부터 씁니다. |
89
- | `lit start work <승인된 계획>` | 승인한 계획을 실행합니다. |
90
- | `review-work` | 변경과 그 근거를 검토합니다. |
91
- | `litresearch` | 출처를 달아 조사하고, 아직 불확실한 부분을 따로 적어 둡니다. |
92
-
93
- 메시지 전체가 그 한 단어일 때만 동작하는 단어가 두 개 있습니다. `handoff`만 보내면 인수인계 문서를 만들고,
94
- `lit-scientific-visualization`만 보내면 시각화 어댑터를 불러옵니다. Python 패키지는 설치하지 않습니다.
95
-
96
- ## 패키지에 들어 있는 스킬
97
-
98
- 아래 스킬은 Codex skill picker에서 고를 수 있고, `$litcodex:lit-humanizer`, `$litcodex:lit-fetch`,
99
- `$litcodex:lit-handoff`, `$litcodex:lit-scientific-visualization`처럼 `$litcodex:` 접두어를 붙인 이름으로 불러도 됩니다. 스킬마다 그림을
100
- 곁들인 설명은 GitHub에 있습니다.
101
-
102
- **작업을 계획하고 실행하기**
103
-
104
- - `lit-loop`(`lit`): 세션이 바뀌어도 이어지는 루프 안에서 일하고, 확인하지 못한 것은 그대로 적어 둡니다.
105
- - `litwork`: 처음부터 끝까지 꼼꼼한 구현이나 수정입니다. 실패하는 테스트 먼저, 그다음 실제 화면에서 증명합니다.
106
- - `lit-plan`: `.litcodex/plans/`에 번호 붙은 승인 계획을 만듭니다. 계획만 세웁니다.
107
- - Start Work(`lit start work <승인된 계획>`): 승인된 계획을 다섯 관문으로 실행합니다.
108
- - `litgoal`: 관찰 가능한 기준을 붙인 목표 하나를 루프에 묶습니다.
109
- - `deep-interview`: 만들 수 있을 만큼 분명해질 때까지 한 번에 한 질문씩 묻습니다.
110
- - `lit-crucible`: 계획 전에 요구사항을 반박해 보고, 반박을 견딘 위험만 계획으로 넘깁니다.
111
- - `lit-team`: 여러 작업자에게 겹치지 않는 몫을 나누고, 각자 증거와 함께 보고하게 합니다.
112
- - `lit-recap`, `lit-handoff`: 지금 상태를 읽기 전용으로 요약하고, 다음 세션이 이어받을 파일을 만듭니다.
113
-
114
- **검토, 조사, 지식**
115
-
116
- - `review-work`: 리뷰 다섯 개가 따로 돌고, 하나라도 통과하지 못하면 승인이 나지 않습니다.
117
- - `litresearch`: 조사를 요청할 때만 움직이며, 여러 갈래로 증거를 모아 출처와 함께 종합합니다.
118
- - `autoresearch`: 승인된 예산 안에서 실험을 반복합니다.
119
- - `autoconference`: 예산을 정해 두고 연구 회의를 엽니다.
120
- - `lit-fetch`: 보통 방법으로 부족할 때 주소·DNS·본문 안전 검사를 거쳐 공개 페이지를 읽습니다.
121
- - `wikify`: 검토를 거친 프로젝트 지식을 디스크에 두고, 나중 질문에 출처와 함께 답합니다.
122
- - `coding-session-audit`: 지난 Codex 세션을 기록으로 읽고 어디서 멈췄는지 보여 줍니다.
123
- - `lit-comprehend`: 에이전트가 쓴 작업을 이해하도록 돕는 설명 페이지를 만들고, 짧은 퀴즈로 마무리합니다.
124
-
125
- **문서, 그림, 화면**
126
-
127
- - `lit-docx`, `lit-pptx`: 여섯 방향 중 하나로 절제된 Word 문서를, 여덟 방향 중 하나로 빽빽한 PowerPoint 파일을 원고 Markdown과 함께 만듭니다. 만들기 전에 고른 방향과 대안 두 가지를 밝힙니다.
128
- - `lit-diagram-drawer`: 편집 가능한 다이어그램을 그리고 검사한 뒤 PNG와 Office용 SVG로 내보냅니다.
129
- - `lit-scientific-visualization`: 학술지 규격 그림을 벡터와 600 DPI로 내보냅니다.
130
- - `lit-typographic-motion`: 트리트먼트부터 쓰고 짧은 영상을 만듭니다.
131
- - `lit-humanizer`: 딱딱한 AI 문장을 한국어나 영어로 다시 씁니다. 사실과 단서는 남깁니다.
132
- - `readme-studio`: 사실에 맞는 README와 움직이는 커버를 만듭니다.
133
- - `frontend-ui-ux`, `visual-qa`, `browser-drive`: 화면을 만들고, 실제 화면을 폭별로 확인하고, 브라우저
134
- 드라이버를 확인한 뒤 실제 페이지를 조작합니다.
135
-
136
- **코드**
137
-
138
- - `debugging`: 버그를 재현하고, 가설을 세 개 이상 세워 확인한 뒤, 확인된 원인만 고칩니다.
139
- - `refactor`: 동작을 테스트로 고정한 채 코드 구조를 바꿉니다.
140
- - `lit-code`: 테스트 먼저, 경계에서 타입 확인 같은 엄격한 구현 규칙입니다.
141
- - `lit-commit`: 변경을 저장소 스타일에 맞는 작은 커밋으로 나눕니다.
142
- - `lit-burnoff`, `lit-burnoff-file`: 변경분 전체나 파일 하나에서 AI식 군더더기를 걷어냅니다.
143
- - `structural-search`: 문법 구조로 코드를 찾고, 바꾸기 전에 결과를 미리 보여 줍니다.
144
- - `lsp-setup`, `lit-init`: 언어 서버 설정을 확인하고, 필요한 곳에만 짧은 AGENTS.md 안내를 만듭니다.
145
-
146
- **LitCodex 관리**
147
-
148
- - `litcodex-doctor`, `litcodex-report-bug`, `litcodex-contribute-bug-fix`: 설치 상태 점검, 출처를 단 버그 보고서,
149
- 테스트가 붙은 수정 PR입니다.
150
- - `rules`, `lsp`, `comment-checker`는 알아서 돌아갑니다. 프롬프트마다 프로젝트 규칙을 넣고, 수정 뒤에는 LSP와
151
- 주석을 확인합니다.
63
+ - **루프와 계획:** `lit-loop`(`lit`), `litwork`, `lit-plan`, Start Work(`lit start work <승인된 계획>`), `litgoal`,
64
+ `deep-interview`, `lit-crucible`, `lit-team`, `lit-recap`, `lit-handoff`.
65
+ - **검토와 조사:** `review-work`, `litresearch`, `autoresearch`, `autoconference`, `lit-fetch`, `wikify`,
66
+ `coding-session-audit`, `lit-comprehend`.
67
+ - **문서, 그림, 화면:** `lit-docx`, `lit-pptx`, `lit-diagram-drawer`, `lit-scientific-visualization`,
68
+ `lit-typographic-motion`, `lit-humanizer`, `readme-studio`, `frontend-ui-ux`, `visual-qa`, `browser-drive`.
69
+ - **코드:** `debugging`, `refactor`, `lit-code`, `lit-commit`, `lit-burnoff`, `lit-burnoff-file`,
70
+ `structural-search`, `lsp-setup`, `lit-init`.
71
+ - **관리:** `litcodex-doctor`, `litcodex-report-bug`, `litcodex-contribute-bug-fix`. `rules`, `lsp`,
72
+ `comment-checker`는 알아서 돌아갑니다.
152
73
 
153
74
  ## 설치하면 달라지는 것
154
75
 
155
- Codex가 플러그인을 불러오고 훅을 실행합니다. 훅은 요청이 어떤 모드에 속하는지 가리고, 스킬은 에이전트의 작업
156
- 절차를 안내하며, 루프 CLI는 프로젝트 기록을 관리합니다. Codex 목표 도구는 LitCodex가 직접 부르지 않고, 도구가
157
- 있을 때 에이전트가 씁니다. 멈췄거나(paused) 막힌(blocked) 목표는 아래 복구 절차를 따르세요.
158
-
159
76
  - Codex에 플러그인·훅·에이전트가 등록되고 `~/.codex/config.toml`의 관리 항목이 갱신됩니다. 관련 없는 Codex
160
- 설정은 그대로 둡니다. `--reconfigure` 전에는 바뀔 내용을 먼저 확인하세요.
161
- - 고른 모델은 설정 파일에 적히는 값입니다. 그 모델을 실제로 쓸 수 있는지, 실제로 도는지는 Codex와 사용자 계정에 달려 있습니다.
77
+ 설정은 그대로 둡니다.
162
78
  - 프로젝트마다 `.litcodex/lit-loop/` 아래에 로컬 기록이 생기며, Git과 패키지에서는 제외됩니다.
163
- - doctor 진단은 Codex 설정, 설치 상태, 플러그인 상태를 바꾸지 않고 살펴보기만 합니다. 터미널에서 직접 실행해
164
- 성공적으로 끝난 doctor처럼 조건에 맞는 실행이면 캐시해 둔 새 버전 안내가 뜰 수 있고, 백그라운드 작업이 정해진
165
- 레지스트리만 조회해 `~/.litcodex/update-check.json`에 적어 둡니다. 이 작업은 아무것도 설치하지 않습니다. 이와
166
- 별개로, 조건에 맞는 대화형 관리 명령 뒤에는 업데이트 실행기가 새 전역 패키지를 설치할 수 있습니다.
167
- `LITCODEX_NO_UPDATE_CHECK=1`을 설정하면 둘 다 꺼집니다. 실패했거나 `--json`·`--dry-run`으로 돌렸거나,
168
- 비TTY·CI 환경이거나 이 설정으로 끈 doctor 실행은 부수 효과가 없습니다.
79
+ - doctor 진단은 Codex 설정, 설치 상태, 플러그인 상태를 바꾸지 않고 살펴보기만 합니다. 조건에 맞는 대화형 doctor
80
+ 실행 뒤에는 캐시해 둔 새 버전 안내가 뜰 수 있고, 백그라운드 작업이 정해진 레지스트리만 조회해
81
+ `~/.litcodex/update-check.json`에 적어 둡니다. 이 작업은 아무것도 설치하지 않습니다. 이와 별개로, 조건에 맞는
82
+ 대화형 관리 명령 뒤에는 업데이트 실행기가 새 전역 패키지를 설치할 수 있습니다. `LITCODEX_NO_UPDATE_CHECK=1`을
83
+ 설정하면 둘 다 꺼집니다. 실패했거나 `--json`·`--dry-run`으로 돌렸거나, 비TTY·CI 환경이거나 이 설정으로 끈
84
+ doctor 실행은 부수 효과가 없습니다.
85
+ - 선택 기능 두 가지는 기본값이 꺼짐입니다.
86
+ [자동 핸드오프](https://github.com/wjgoarxiv/litcodex/blob/main/docs/auto-handoff-Ko-KR.md)와, 켜면 프롬프트가
87
+ 외부 서비스로 가는 [Jev 스킬 힌트](https://github.com/wjgoarxiv/litcodex/blob/main/docs/jev-skill-hint-Ko-KR.md)입니다.
169
88
  - 테스트, 픽스처, 테스트 헬퍼, Vitest 설정은 저장소에만 있습니다. npm 패키지와 설치된 마켓플레이스 플러그인에는
170
89
  들어가지 않습니다.
171
90
 
172
- 선택 기능인 Jev 스킬 힌트는 평범한 요청에 맞는 번들 스킬을 제안해 주며, 기본값은 꺼짐입니다.
173
- 켜면(`LITCODEX_JEV=1`과 본인의 `TYPESAFE_API_KEY`) 조건에 맞는 프롬프트가 매번 TypeSafe(typesafe.ai)로 갑니다.
174
- 2,000자로 자르고 홈 경로, 이메일 주소, 토큰 형태의 문자열을 가린 뒤 나머지는 그대로 보냅니다. 파일, 도구 출력,
175
- 대화 기록은 보내지 않습니다. 켜기 전에
176
- [전체 설명](https://github.com/wjgoarxiv/litcodex/blob/main/README-Ko-KR.md#jev-스킬-힌트-선택)(각 상태가 화면에서 어떻게 보이는지도 나옵니다)과
177
- [개인정보 안내](https://github.com/wjgoarxiv/litcodex/blob/main/docs/privacy.md#optional-jev-skill-hint)를 읽어 주세요.
178
-
179
- 선택 기능인 자동 핸드오프는 대화가 정해 둔 퍼센트에 이르면 핸드오프를 대신 써 주며, 기본값은 꺼짐입니다.
180
- `lit-handoff auto on 60`(1에서 99 사이의 정수)을 프롬프트 전체로 보내면 켜지고, `lit-handoff auto off`로 끕니다.
181
- Codex에서는 모델이 핸드오프를 저장하고 그 턴이 끝나면 Codex가 압축합니다(Codex CLI 0.158 이상, 신뢰한 프로젝트).
182
- Codex가 압축하도록 설정되어 있지 않으면 `/compact`를 실행하라는 한 줄이 나오고, 이후 핸드오프는 저절로 다시
183
- 불러옵니다. 각 단계는 [전체 설명](https://github.com/wjgoarxiv/litcodex/blob/main/README-Ko-KR.md#자동-핸드오프-선택)을 읽어 주세요.
184
-
185
91
  ## 확인, 문제 해결, 제거
186
92
 
187
93
  ```sh
188
- npm exec --yes --package @litfamily/litcodex@1.0.18 -- litcodex doctor
94
+ npm exec --yes --package @litfamily/litcodex@1.0.19 -- litcodex doctor
189
95
  ```
190
96
 
191
97
  `litcodex doctor`는 등록·훅·설정·호스트 기능을, `litcodex loop doctor`는 현재 프로젝트의 루프 상태를 확인합니다.
192
- 둘 다 설치 상태를 보는 검사이고, 로그인한 모델 작업이 실제로 도는지는 작은 작업을 하나 맡겨 보면 알 수 있습니다.
193
-
194
- - **`lit`을 입력해도 반응이 없다면.** `litcodex doctor`를 실행하고 Codex에서 훅을 승인했는지 확인하세요.
195
- - **명령을 찾지 못한다면.** 위의 `npm exec` 형식을 쓰거나, npm 전역 bin 경로를 `PATH`에 넣으세요.
196
- - **Codex 목표가 멈췄거나(paused) 막혔다면(blocked).** `/goal resume`으로 재개하고 활성 상태인지 확인한 뒤
197
- `litcodex loop run --retry-failed`로 다시 시도하세요. 미완료 목표는 지우지 말고 남겨 두세요.
198
- - **아무 출력 없이 창(pane)이 닫힌다면.** 어느 단계가 문제인지부터 찾습니다. 열린 터미널에서 도움말, 설치,
199
- doctor를 하나씩 실행해 각 종료 코드를 적어 두고
200
- [문제 해결](https://github.com/wjgoarxiv/litcodex/blob/main/README-Ko-KR.md#문제-해결)을 참고하세요.
98
+ `lit`을 입력해도 반응이 없다면 doctor를 실행하고 Codex에서 훅을 승인했는지 확인하세요. 다른 해결 방법은
99
+ [문제 해결](https://github.com/wjgoarxiv/litcodex/blob/main/README-Ko-KR.md#문제-해결)에 있습니다.
201
100
 
202
101
  ```sh
203
- npm exec --yes --package @litfamily/litcodex@1.0.18 -- litcodex uninstall
102
+ npm exec --yes --package @litfamily/litcodex@1.0.19 -- litcodex uninstall
204
103
  ```
205
104
 
206
105
  플러그인과 LitCodex가 관리하는 설정을 지우고, 관련 없는 설정은 그대로 둡니다.
package/README.md CHANGED
@@ -1,64 +1,46 @@
1
- <p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.18/readme-assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.18/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.19/readme-assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.19/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.18/readme-assets/badge-version.svg" alt="1.0.18" /></a>
5
- <a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.18/readme-assets/badge-license.svg" alt="MIT license" /></a>
4
+ <a href="#install"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.19/readme-assets/badge-version.svg" alt="1.0.19" /></a>
5
+ <a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.19/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.18/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.18/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.18/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.19/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.19/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.19/readme-assets/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
10
10
  </p>
11
11
 
12
12
  # LitCodex
13
13
 
14
14
  **Keep the work lit.**
15
15
 
16
- LitCodex is a plugin for Codex CLI. It adds planning, review, research and a durable execution loop, so a
17
- piece of work can outlast the conversation it started in. Add `lit` to a request, and the goal, its checks and
18
- the results stay in your project, where a later session can pick them up.
16
+ A plugin for Codex CLI that turns a request into a goal with checks, keeps the evidence in your project,
17
+ and hands unfinished work to the next session.
19
18
 
20
- **[Full guide and skills gallery on GitHub](https://github.com/wjgoarxiv/litcodex#readme)** · [한국어](https://github.com/wjgoarxiv/litcodex/blob/main/packages/litcodex-ai/README-Ko-KR.md)
19
+ **[Full guide on GitHub](https://github.com/wjgoarxiv/litcodex#readme)** · [한국어](https://github.com/wjgoarxiv/litcodex/blob/main/packages/litcodex-ai/README-Ko-KR.md)
21
20
 
22
21
  ## Install
23
22
 
24
23
  You need Node.js 22 or later and Codex CLI.
25
24
 
26
25
  ```sh
27
- npm exec --yes --package @litfamily/litcodex@1.0.18 -- litcodex install
26
+ npm exec --yes --package @litfamily/litcodex@1.0.19 -- litcodex install
28
27
  ```
29
28
 
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.18 -- litcodex --dry-run install`. To install without
35
- any questions, add `--yes` after `install`.
36
-
37
- For a global command:
29
+ The installer asks which model leads, which model helps and which output style you like, shows what it is
30
+ about to write, and changes only the keys it manages in `~/.codex/config.toml`. To see the plan first, run
31
+ `npm exec --yes --package @litfamily/litcodex@1.0.19 -- litcodex --dry-run install`. To skip the
32
+ questions, add `--yes` after `install`.
38
33
 
39
34
  ```sh
40
35
  npm install -g @litfamily/litcodex
41
36
  litcodex install
42
37
  ```
43
38
 
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.
50
-
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.
39
+ A global install also gets the video skill's tools ready with a few pinned downloads. The
40
+ [install guide](https://github.com/wjgoarxiv/litcodex/blob/main/docs/install.md#a-global-command) lists them
41
+ and shows how to skip them.
54
42
 
55
- > Without a global install, use `npm exec --yes --package @litfamily/litcodex@1.0.18 -- litcodex <command>`.
56
-
57
- To try LitCodex apart from your existing settings, follow the
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`.
43
+ > Without a global install, use `npm exec --yes --package @litfamily/litcodex@1.0.19 -- litcodex <command>`.
62
44
 
63
45
  ## First task
64
46
 
@@ -68,101 +50,34 @@ Open Codex in your project, approve the LitCodex hooks in the startup review, an
68
50
  lit add input validation to the signup form
69
51
  ```
70
52
 
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.
74
-
75
- For a first run you can judge yourself, try this in an empty folder:
76
-
77
- ```text
78
- lit build a single-file HTML task list in this folder. Do not install dependencies.
79
- Check adding and completing a task, and record anything you could not verify.
80
- ```
81
-
82
- Then look at the result, the checks that actually ran, and what is still open. `lit recap` reads back what
83
- was recorded, and sending `handoff` on its own before you leave gives the next session a place to start.
84
-
85
- ## Routes people use most
53
+ The reply opens with `🔥 **LIT IGNITED · <discipline>** 🔥`. A goal is complete once every check has
54
+ passing evidence, and the records live under `.litcodex/lit-loop/` in your project; `lit recap` reads them
55
+ back. Send exact bare `handoff` before you leave, and the next session gets a continuation packet to start
56
+ from. The exact bare `lit-scientific-visualization` hook route loads the plotting adapter;
57
+ it does not install Python dependencies.
86
58
 
87
- | Type this | What happens |
88
- | --- | --- |
89
- | `lit` | Starts a bounded task, with goals and checks kept in the project. |
90
- | `handoff` or `/lit-handoff` | Carries the checked result and the next step into another session. |
91
- | `lit-plan` | Writes a plan and success criteria before anything is edited. |
92
- | `lit start work <approved-plan>` | Runs a plan you have approved. |
93
- | `review-work` | Reviews the change and its evidence. |
94
- | `litresearch` | Researches with sources and keeps track of what is still uncertain. |
59
+ ## Skills
95
60
 
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.
61
+ Pick any skill in the Codex skill picker or mention it by scoped name, such as `$litcodex:lit-humanizer`,
62
+ `$litcodex:lit-fetch`, `$litcodex:lit-handoff` or `$litcodex:lit-scientific-visualization`. The
63
+ [skills page](https://github.com/wjgoarxiv/litcodex/blob/main/docs/skills.md) has a picture of each one.
99
64
 
100
- ## What else is in the package
101
-
102
- You can pick these skills in the Codex skill picker or mention one by scoped name, such as
103
- `$litcodex:lit-humanizer`, `$litcodex:lit-fetch`, `$litcodex:lit-handoff` or
104
- `$litcodex:lit-scientific-visualization`. The GitHub page has a picture for each one.
105
-
106
- **Planning and running work**
107
-
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.
110
- - `lit-plan`: an approved plan with numbered rows in `.litcodex/plans/`; planning only.
111
- - Start Work (`lit start work <approved-plan>`): runs an approved plan through five gates.
112
- - `litgoal`: binds one goal with observable criteria to the loop.
113
- - `deep-interview`: one question at a time until the idea is clear enough to build.
114
- - `lit-crucible`: pressure-tests a brief before planning, so only surviving risks reach the plan.
115
- - `lit-team`: gives several workers separate slices, each reporting back with evidence.
116
- - `lit-recap` and `lit-handoff`: a read-only summary of where things stand, and a file the next session resumes from.
117
-
118
- **Review, research and knowledge**
119
-
120
- - `review-work`: five separate reviews, and any one of them can hold back approval.
121
- - `litresearch`: parallel evidence gathering and a cited synthesis, only when you ask for research.
122
- - `autoresearch` and `autoconference`: an approved, budgeted experiment loop, and a budgeted research conference.
123
- - `lit-fetch`: reads a public page with URL, DNS and text-safety checks when ordinary retrieval falls short.
124
- - `wikify`: keeps reviewed project knowledge on disk and answers later questions from it, with sources.
125
- - `coding-session-audit`: reads a past Codex session from its evidence and shows where it stopped.
126
- - `lit-comprehend`: an explainer page for agent-written work, ending in a short quiz.
127
-
128
- **Documents, figures and interfaces**
129
-
130
- - `lit-docx` and `lit-pptx`: a restrained Word document in one of six directions or a dense PowerPoint deck in one of eight, each with its Markdown source. The skill names the direction it chose and two alternatives before it builds.
131
- - `lit-diagram-drawer`: an editable diagram, checked and exported to PNG and Office-safe SVG.
132
- - `lit-scientific-visualization`: a journal-sized figure with vector and 600 DPI exports.
133
- - `lit-typographic-motion`: a short film, starting from a written treatment.
134
- - `lit-humanizer`: rewrites stiff model prose in English or Korean, keeping facts and hedges.
135
- - `readme-studio`: a factual README with a moving cover.
136
- - `frontend-ui-ux`, `visual-qa` and `browser-drive`: builds an interface, checks a real screen at each
137
- viewport, and drives a real page once the browser driver is verified.
138
-
139
- **Code**
140
-
141
- - `debugging`: reproduces the bug, tests at least three explanations, fixes only the confirmed cause.
142
- - `refactor`: restructures code while tests pin its behavior.
143
- - `lit-code`: strict implementation rules, with tests first and typed boundaries.
144
- - `lit-commit`: atomic commits in the repository's own style.
145
- - `lit-burnoff` and `lit-burnoff-file`: clean AI-written bloat from a change set or from one file.
146
- - `structural-search`: finds code by syntax shape and previews rewrites.
147
- - `lsp-setup` and `lit-init`: language-server setup checks, and sparse AGENTS.md guidance.
148
-
149
- **Keeping LitCodex healthy**
150
-
151
- - `litcodex-doctor`, `litcodex-report-bug` and `litcodex-contribute-bug-fix`: install health checks, a
152
- source-backed bug report, and a tested bug-fix PR.
153
- - `rules`, `lsp` and `comment-checker` run on their own: project rules on each prompt, LSP and comment
154
- checks after edits.
65
+ - **Loop and planning:** `lit-loop` (`lit`), `litwork`, `lit-plan`, Start Work (`lit start work <approved-plan>`),
66
+ `litgoal`, `deep-interview`, `lit-crucible`, `lit-team`, `lit-recap` and `lit-handoff`.
67
+ - **Review and research:** `review-work`, `litresearch`, `autoresearch`, `autoconference`, `lit-fetch`,
68
+ `wikify`, `coding-session-audit` and `lit-comprehend`.
69
+ - **Documents, figures and screens:** `lit-docx`, `lit-pptx`, `lit-diagram-drawer`,
70
+ `lit-scientific-visualization`, `lit-typographic-motion`, `lit-humanizer`, `readme-studio`,
71
+ `frontend-ui-ux`, `visual-qa` and `browser-drive`.
72
+ - **Code:** `debugging`, `refactor`, `lit-code`, `lit-commit`, `lit-burnoff`, `lit-burnoff-file`,
73
+ `structural-search`, `lsp-setup` and `lit-init`.
74
+ - **Upkeep:** `litcodex-doctor`, `litcodex-report-bug` and `litcodex-contribute-bug-fix`. `rules`, `lsp`
75
+ and `comment-checker` run on their own.
155
76
 
156
77
  ## What it changes
157
78
 
158
- 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. LitCodex never calls Codex's goal tools
160
- itself; the agent uses them when they are there. A paused or blocked goal needs the recovery step below.
161
-
162
79
  - Codex gets the plugin, hooks and agents, plus the managed keys in `~/.codex/config.toml`. Your unrelated
163
- Codex settings stay as they are. Look at the planned changes before you use `--reconfigure`.
164
- - The model you pick is a setting in your config. Whether it is open to you, and whether it actually
165
- runs, is up to Codex and your account.
80
+ Codex settings stay as they are.
166
81
  - Each project gets local records under `.litcodex/lit-loop/`, kept out of Git and packages.
167
82
  - The doctor diagnostic core never modifies Codex config, install state or plugin state. An eligible
168
83
  interactive doctor run (a successful one you start by hand) may show a cached advisory notice about a
@@ -171,44 +86,25 @@ itself; the agent uses them when they are there. A paused or blocked goal needs
171
86
  global package after an eligible interactive management command. Set `LITCODEX_NO_UPDATE_CHECK=1` to
172
87
  turn off both. A doctor run that failed, or ran with `--json`, `--dry-run`, in a non-TTY or CI shell, or
173
88
  with the opt-out set, stays side-effect-free.
89
+ - Two optional features are off by default:
90
+ [automatic handoff](https://github.com/wjgoarxiv/litcodex/blob/main/docs/auto-handoff.md) and the
91
+ [Jev skill hint](https://github.com/wjgoarxiv/litcodex/blob/main/docs/jev-skill-hint.md), which sends
92
+ prompts to a third party once you turn it on.
174
93
  - Tests, fixtures, test helpers and the Vitest configuration live only in the repository. Neither the npm
175
94
  package nor the installed marketplace plugin includes them.
176
95
 
177
- The optional Jev skill hint suggests a bundled skill for a plain prompt, and it is off by default.
178
- Turning it on (`LITCODEX_JEV=1` plus your own `TYPESAFE_API_KEY`) sends each eligible prompt to TypeSafe
179
- (typesafe.ai). The prompt is cut to 2,000 characters and home paths, email addresses and token-shaped
180
- strings are redacted; the rest of it is sent as written. Nothing else from the session goes with it:
181
- no files, tool output or history.
182
- Read [the full description](https://github.com/wjgoarxiv/litcodex#jev-skill-hint-optional), which shows what
183
- appears on screen in each state, and the
184
- [privacy notes](https://github.com/wjgoarxiv/litcodex/blob/main/docs/privacy.md#optional-jev-skill-hint)
185
- before you turn it on.
186
-
187
- The optional automatic handoff writes a handoff for you when a conversation reaches a percent you choose,
188
- and is off by default. Turn it on by sending `lit-handoff auto on 60` (any whole number from 1 to 99) as your
189
- whole prompt, and off with `lit-handoff auto off`. On Codex the model saves the handoff and Codex compacts
190
- after that turn (Codex CLI 0.158 or newer, trusted project); when Codex is not set to compact, you get one
191
- line asking you to run `/compact`. The handoff then comes back on its own. Read
192
- [the full description](https://github.com/wjgoarxiv/litcodex#automatic-handoff-optional) for each step.
193
-
194
96
  ## Check, fix, remove
195
97
 
196
98
  ```sh
197
- npm exec --yes --package @litfamily/litcodex@1.0.18 -- litcodex doctor
99
+ npm exec --yes --package @litfamily/litcodex@1.0.19 -- litcodex doctor
198
100
  ```
199
101
 
200
- `litcodex doctor` checks registration, hooks, config and host capabilities; `litcodex loop doctor` checks the
201
- current project's loop state. Both look at the setup; a small real task shows whether signed-in model work runs.
202
-
203
- - **`lit` does nothing.** Run `litcodex doctor` and check that the hooks are approved in Codex.
204
- - **The command is missing.** Use the `npm exec` form above, or put npm's global bin directory on your `PATH`.
205
- - **A native goal is paused or blocked.** Run `/goal resume`, confirm the goal is active, then retry with
206
- `litcodex loop run --retry-failed`. Keep the unfinished goal.
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).
102
+ `litcodex doctor` checks registration, hooks, config and host capabilities; `litcodex loop doctor` checks
103
+ the current project's loop state. If `lit` does nothing, run doctor and check that the hooks are approved
104
+ in Codex. More fixes are under [troubleshooting](https://github.com/wjgoarxiv/litcodex#troubleshooting).
209
105
 
210
106
  ```sh
211
- npm exec --yes --package @litfamily/litcodex@1.0.18 -- litcodex uninstall
107
+ npm exec --yes --package @litfamily/litcodex@1.0.19 -- litcodex uninstall
212
108
  ```
213
109
 
214
110
  This removes the plugin and the config LitCodex manages, and leaves your other settings alone.
@@ -1,5 +1,6 @@
1
1
  import { type CheckGate } from "./update-check.js";
2
- export declare const FOREGROUND_AUTO_UPDATE_TIMEOUT_MS = 55000;
2
+ /** Longer than the helper's worst case (three probes and four install steps), so it is never cut mid-rollback. */
3
+ export declare const FOREGROUND_AUTO_UPDATE_TIMEOUT_MS = 300000;
3
4
  export interface ForegroundAutoUpdateOptions extends CheckGate {
4
5
  readonly current: string;
5
6
  readonly stderr: NodeJS.WritableStream;
@@ -3,7 +3,8 @@ import { existsSync } from "node:fs";
3
3
  import { dirname, join } from "node:path";
4
4
  import { fileURLToPath } from "node:url";
5
5
  import { shouldCheck } from "./update-check.js";
6
- export const FOREGROUND_AUTO_UPDATE_TIMEOUT_MS = 55_000;
6
+ /** Longer than the helper's worst case (three probes and four install steps), so it is never cut mid-rollback. */
7
+ export const FOREGROUND_AUTO_UPDATE_TIMEOUT_MS = 300_000;
7
8
  /**
8
9
  * Run the installed component's updater synchronously after a successful eligible command.
9
10
  *
package/dist/cli.d.ts CHANGED
@@ -20,4 +20,4 @@ export declare function dispatch(argv: readonly string[]): DispatchResult;
20
20
  * (M13, in-process), and the bundled `@litcodex/lit-loop` runtime routes `loop`/`hook`. Returns the
21
21
  * integer exit code; the bin owns `process.exit`. No forwarding, no exec-wrapper, no harness.
22
22
  */
23
- export declare function runCli(argv: readonly string[]): Promise<number>;
23
+ export declare function runCli(rawArgv: readonly string[]): Promise<number>;