@litfamily/litcodex 1.0.36 → 1.0.38
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 +9 -9
- package/README.md +9 -9
- package/dist/install/codex-version.js +1 -1
- package/marketplace/plugins/litcodex/.codex-plugin/plugin.json +1 -1
- package/marketplace/plugins/litcodex/components/auto-update/package.json +1 -1
- package/marketplace/plugins/litcodex/components/comment-checker/package.json +1 -1
- package/marketplace/plugins/litcodex/components/git-bash/package.json +1 -1
- package/marketplace/plugins/litcodex/components/lit-loop/directives/lit-adhd.md +32 -13
- package/marketplace/plugins/litcodex/components/lit-loop/dist/hook-cli.js +2 -1
- package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-board.d.ts +192 -0
- package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-board.js +437 -0
- package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-cli.js +17 -3
- package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-go.d.ts +3 -2
- package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind-go.js +6 -4
- package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind.d.ts +9 -2
- package/marketplace/plugins/litcodex/components/lit-loop/dist/rewind.js +245 -30
- package/marketplace/plugins/litcodex/components/lit-loop/dist/route-heads.js +3 -3
- package/marketplace/plugins/litcodex/components/lit-loop/dist/state-types.d.ts +1 -1
- package/marketplace/plugins/litcodex/components/lit-loop/dist/state-types.js +2 -0
- package/marketplace/plugins/litcodex/components/lit-loop/dist/workflow-map.js +5 -1
- package/marketplace/plugins/litcodex/components/lit-loop/dist/workflow-stack.js +1 -1
- package/marketplace/plugins/litcodex/components/lit-loop/package.json +1 -1
- package/marketplace/plugins/litcodex/components/lsp/package.json +1 -1
- package/marketplace/plugins/litcodex/components/rules/package.json +1 -1
- package/marketplace/plugins/litcodex/components/start-work-continuation/directive.md +5 -5
- package/marketplace/plugins/litcodex/components/start-work-continuation/dist/cli.js +30 -5
- package/marketplace/plugins/litcodex/components/start-work-continuation/dist/codex-hook.d.ts +6 -5
- package/marketplace/plugins/litcodex/components/start-work-continuation/dist/codex-hook.js +184 -62
- package/marketplace/plugins/litcodex/components/start-work-continuation/dist/host-reads.d.ts +7 -0
- package/marketplace/plugins/litcodex/components/start-work-continuation/dist/host-reads.js +30 -0
- package/marketplace/plugins/litcodex/components/start-work-continuation/dist/index.d.ts +9 -4
- package/marketplace/plugins/litcodex/components/start-work-continuation/dist/index.js +5 -2
- package/marketplace/plugins/litcodex/components/start-work-continuation/dist/lifecycle-root.d.ts +9 -0
- package/marketplace/plugins/litcodex/components/start-work-continuation/dist/lifecycle-root.js +117 -0
- package/marketplace/plugins/litcodex/components/start-work-continuation/dist/lifecycle-store.d.ts +72 -1
- package/marketplace/plugins/litcodex/components/start-work-continuation/dist/lifecycle-store.js +525 -103
- package/marketplace/plugins/litcodex/components/start-work-continuation/dist/pre-tool-hook.d.ts +8 -0
- package/marketplace/plugins/litcodex/components/start-work-continuation/dist/pre-tool-hook.js +131 -0
- package/marketplace/plugins/litcodex/components/start-work-continuation/dist/protected-paths.d.ts +13 -0
- package/marketplace/plugins/litcodex/components/start-work-continuation/dist/protected-paths.js +103 -0
- package/marketplace/plugins/litcodex/components/start-work-continuation/dist/work-state-reader.d.ts +14 -2
- package/marketplace/plugins/litcodex/components/start-work-continuation/dist/work-state-reader.js +14 -4
- package/marketplace/plugins/litcodex/components/start-work-continuation/package.json +1 -1
- package/marketplace/plugins/litcodex/components/telemetry/package.json +1 -1
- package/marketplace/plugins/litcodex/components/wikify-knowledge/package.json +1 -1
- package/marketplace/plugins/litcodex/hooks/hooks.json +11 -0
- package/marketplace/plugins/litcodex/skills/lit-adhd/SKILL.md +43 -21
- package/marketplace/plugins/litcodex/skills/lit-adhd/agents/openai.yaml +1 -1
- package/marketplace/plugins/litcodex/skills/lit-adhd/references/card-examples.md +103 -3
- package/marketplace/plugins/litcodex/skills/lit-adhd/references/status-taxonomy.md +19 -1
- package/marketplace/plugins/litcodex/skills/start-work/SKILL.md +18 -4
- package/node_modules/@litcodex/lit-loop/directives/lit-adhd.md +32 -13
- package/node_modules/@litcodex/lit-loop/dist/hook-cli.js +2 -1
- package/node_modules/@litcodex/lit-loop/dist/rewind-board.d.ts +192 -0
- package/node_modules/@litcodex/lit-loop/dist/rewind-board.js +437 -0
- package/node_modules/@litcodex/lit-loop/dist/rewind-cli.js +17 -3
- package/node_modules/@litcodex/lit-loop/dist/rewind-go.d.ts +3 -2
- package/node_modules/@litcodex/lit-loop/dist/rewind-go.js +6 -4
- package/node_modules/@litcodex/lit-loop/dist/rewind.d.ts +9 -2
- package/node_modules/@litcodex/lit-loop/dist/rewind.js +245 -30
- package/node_modules/@litcodex/lit-loop/dist/route-heads.js +3 -3
- package/node_modules/@litcodex/lit-loop/dist/state-types.d.ts +1 -1
- package/node_modules/@litcodex/lit-loop/dist/state-types.js +2 -0
- package/node_modules/@litcodex/lit-loop/dist/workflow-map.js +5 -1
- package/node_modules/@litcodex/lit-loop/dist/workflow-stack.js +1 -1
- package/node_modules/@litcodex/lit-loop/package.json +1 -1
- package/node_modules/@litcodex/lit-loop/skills/lit-adhd/SKILL.md +43 -21
- package/node_modules/@litcodex/lit-loop/skills/start-work/SKILL.md +18 -4
- package/package.json +2 -2
- package/readme-assets/badge-version.svg +1 -1
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.
|
|
1
|
+
<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.38/readme-assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.38/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.
|
|
5
|
-
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.
|
|
4
|
+
<a href="#설치"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.38/readme-assets/badge-version.svg" alt="1.0.38" /></a>
|
|
5
|
+
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.38/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
|
+
<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.38/readme-assets/lucide-book-open.svg" width="16" alt="" /> 문서</a> <a href="#설치">설치</a> <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.38/readme-assets/lucide-play.svg" width="16" alt="" /> Ignition</a> <a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.38/readme-assets/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
|
|
10
10
|
</p>
|
|
11
11
|
|
|
12
12
|
# LitCodex
|
|
@@ -23,12 +23,12 @@
|
|
|
23
23
|
Node.js 22 이상과 Codex CLI가 필요합니다.
|
|
24
24
|
|
|
25
25
|
```sh
|
|
26
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
26
|
+
npm exec --yes --package @litfamily/litcodex@1.0.38 -- litcodex install
|
|
27
27
|
```
|
|
28
28
|
|
|
29
29
|
설치기는 어떤 모델이 이끌지, 어떤 모델이 거들지, 답변 스타일은 무엇으로 할지 묻고, 쓰려는 내용을 먼저 보여 준 뒤
|
|
30
30
|
`~/.codex/config.toml`에서 자기가 관리하는 항목만 고칩니다. 계획만 먼저 보려면
|
|
31
|
-
`npm exec --yes --package @litfamily/litcodex@1.0.
|
|
31
|
+
`npm exec --yes --package @litfamily/litcodex@1.0.38 -- litcodex --dry-run install`을 실행하고, 묻는 단계 없이
|
|
32
32
|
설치하려면 `install` 뒤에 `--yes`를 붙이세요.
|
|
33
33
|
|
|
34
34
|
```sh
|
|
@@ -39,7 +39,7 @@ litcodex install
|
|
|
39
39
|
전역으로 설치하면 영상 스킬이 쓸 도구를 미리 준비하느라 버전이 고정된 파일 몇 개를 내려받습니다. 무엇을 받는지와
|
|
40
40
|
건너뛰는 방법은 [설치 안내](https://github.com/wjgoarxiv/litcodex/blob/main/docs/install-Ko-KR.md#전역-명령으로-쓰기)에 있습니다.
|
|
41
41
|
|
|
42
|
-
> 전역 설치가 없다면 `npm exec --yes --package @litfamily/litcodex@1.0.
|
|
42
|
+
> 전역 설치가 없다면 `npm exec --yes --package @litfamily/litcodex@1.0.38 -- litcodex <command>` 형식을 사용하세요.
|
|
43
43
|
|
|
44
44
|
## 첫 작업
|
|
45
45
|
|
|
@@ -91,7 +91,7 @@ lit 회원가입 폼에 입력 검증을 추가해줘
|
|
|
91
91
|
## 확인, 문제 해결, 제거
|
|
92
92
|
|
|
93
93
|
```sh
|
|
94
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
94
|
+
npm exec --yes --package @litfamily/litcodex@1.0.38 -- litcodex doctor
|
|
95
95
|
```
|
|
96
96
|
|
|
97
97
|
`litcodex doctor`는 등록·훅·설정·호스트 기능을, `litcodex loop doctor`는 현재 프로젝트의 루프 상태를 확인합니다.
|
|
@@ -99,7 +99,7 @@ npm exec --yes --package @litfamily/litcodex@1.0.36 -- litcodex doctor
|
|
|
99
99
|
[문제 해결](https://github.com/wjgoarxiv/litcodex/blob/main/README-Ko-KR.md#문제-해결)에 있습니다.
|
|
100
100
|
|
|
101
101
|
```sh
|
|
102
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
102
|
+
npm exec --yes --package @litfamily/litcodex@1.0.38 -- litcodex uninstall
|
|
103
103
|
```
|
|
104
104
|
|
|
105
105
|
플러그인과 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.
|
|
1
|
+
<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.38/readme-assets/cover-motion-still.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.38/readme-assets/cover-motion.webp" width="100%" alt="LitFamily motion cover: seven armored machines power on bay by bay, the LitCodex machine in the third bay wakes with a glowing orange visor 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.
|
|
5
|
-
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.
|
|
4
|
+
<a href="#install"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.38/readme-assets/badge-version.svg" alt="1.0.38" /></a>
|
|
5
|
+
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.38/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
|
+
<a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/usage.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.38/readme-assets/lucide-book-open.svg" width="16" alt="" /> Docs</a> <a href="#install">Install</a> <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.38/readme-assets/lucide-play.svg" width="16" alt="" /> Ignition</a> <a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.38/readme-assets/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
|
|
10
10
|
</p>
|
|
11
11
|
|
|
12
12
|
# LitCodex
|
|
@@ -24,12 +24,12 @@ today's stopped.
|
|
|
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.
|
|
27
|
+
npm exec --yes --package @litfamily/litcodex@1.0.38 -- litcodex install
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
The installer asks which model leads, which model helps and which output style you like, shows what it is
|
|
31
31
|
about to write, and changes only the keys it manages in `~/.codex/config.toml`. To see the plan first, run
|
|
32
|
-
`npm exec --yes --package @litfamily/litcodex@1.0.
|
|
32
|
+
`npm exec --yes --package @litfamily/litcodex@1.0.38 -- litcodex --dry-run install`. To skip the
|
|
33
33
|
questions, add `--yes` after `install`.
|
|
34
34
|
|
|
35
35
|
```sh
|
|
@@ -41,7 +41,7 @@ A global install also gets the video skill's tools ready with a few pinned downl
|
|
|
41
41
|
[install guide](https://github.com/wjgoarxiv/litcodex/blob/main/docs/install.md#a-global-command) lists them
|
|
42
42
|
and shows how to skip them.
|
|
43
43
|
|
|
44
|
-
> Without a global install, use `npm exec --yes --package @litfamily/litcodex@1.0.
|
|
44
|
+
> Without a global install, use `npm exec --yes --package @litfamily/litcodex@1.0.38 -- litcodex <command>`.
|
|
45
45
|
|
|
46
46
|
## First task
|
|
47
47
|
|
|
@@ -97,7 +97,7 @@ rather have neither, set `LITCODEX_NO_UPDATE_CHECK=1`. A doctor run that failed,
|
|
|
97
97
|
## Check, fix, remove
|
|
98
98
|
|
|
99
99
|
```sh
|
|
100
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
100
|
+
npm exec --yes --package @litfamily/litcodex@1.0.38 -- litcodex doctor
|
|
101
101
|
```
|
|
102
102
|
|
|
103
103
|
`litcodex doctor` checks registration, hooks, config and host capabilities; `litcodex loop doctor` checks
|
|
@@ -105,7 +105,7 @@ the current project's loop state. If `lit` does nothing, run doctor and check th
|
|
|
105
105
|
in Codex. More fixes are under [troubleshooting](https://github.com/wjgoarxiv/litcodex#troubleshooting).
|
|
106
106
|
|
|
107
107
|
```sh
|
|
108
|
-
npm exec --yes --package @litfamily/litcodex@1.0.
|
|
108
|
+
npm exec --yes --package @litfamily/litcodex@1.0.38 -- litcodex uninstall
|
|
109
109
|
```
|
|
110
110
|
|
|
111
111
|
This removes the plugin and the config LitCodex manages, and leaves your other settings alone.
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
const TESTED_CODEX_VERSIONS = ["0.144.0", "0.144.1"];
|
|
1
|
+
const TESTED_CODEX_VERSIONS = ["0.144.0", "0.144.1", "0.163.0"];
|
|
2
2
|
const MINIMUM_SUPPORTED = { major: 0, minor: 144, patch: 0 };
|
|
3
3
|
const VERSION_PATTERN = /^[ \t]*codex-cli[ \t]+(\d+)\.(\d+)\.(\d+)(-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?(?=\s|$)/u;
|
|
4
4
|
export function classifyCodexVersion(stdout, stderr) {
|
|
@@ -131,30 +131,49 @@ This directive is an LLM-facing contract injected by the LitCodex Codex plugin,
|
|
|
131
131
|
**MANDATORY**: First user-visible line this turn MUST be exactly:
|
|
132
132
|
`🔥 **LIT IGNITED · lit-adhd** 🔥`
|
|
133
133
|
|
|
134
|
-
Print that line verbatim, then
|
|
134
|
+
Print that line verbatim, then show the board. You are now in lit-adhd (alias
|
|
135
135
|
lit-rewind): the read-only "where was I" surface. Your one job is to run the
|
|
136
|
-
bundled collector once, then
|
|
137
|
-
|
|
138
|
-
you never advance the work.
|
|
136
|
+
bundled collector once, then show its KPI board: the one thing to do now and
|
|
137
|
+
what to type, what is done, what is left and what not to forget, across this
|
|
138
|
+
user's Codex sessions and worktrees. You report; you never advance the work.
|
|
139
139
|
|
|
140
140
|
# Read-only contract
|
|
141
141
|
lit-adhd is read-only. You MUST NOT edit product files, start or resume a
|
|
142
|
-
workflow,
|
|
142
|
+
workflow, settle a parked start-work step, run a build or test, or read anything
|
|
143
143
|
outside the collector's output. The collector itself reads Codex session records
|
|
144
144
|
and each worktree's `.litcodex/` state with a byte budget, refuses symlinks,
|
|
145
145
|
masks credential shapes, env values and the home path, and writes at most one
|
|
146
146
|
small note: `.litcodex/adhd/next-<session>.json`, which `go` consumes.
|
|
147
147
|
|
|
148
148
|
# Step 1 - Run the collector once
|
|
149
|
-
Run the route head's collector command (`... lit-loop/dist/cli.js rewind --json
|
|
150
|
-
for
|
|
151
|
-
for the
|
|
149
|
+
Run the route head's collector command (`... lit-loop/dist/cli.js rewind --json --lang <ko|en>`;
|
|
150
|
+
`--lang ko` for a Korean prompt, `--lang en` otherwise; add `--detail` when the user asked
|
|
151
|
+
for the detail list (`lit adhd detail`, `lit adhd 자세히`), `--here` for this worktree only,
|
|
152
|
+
`--since 7d` to widen or narrow the window, `--max <n>` for the session count). The route head carries the exact command with the plugin
|
|
152
153
|
root resolved. Do not open session records, `auth.json`, `config.toml` or anything under
|
|
153
154
|
the Codex home yourself.
|
|
154
155
|
|
|
155
|
-
# Step 2 -
|
|
156
|
-
|
|
157
|
-
|
|
156
|
+
# Step 2 - Show the board, readable in ten seconds
|
|
157
|
+
The JSON's `board` field is the finished KPI board in the language `--lang` chose. Show it as given:
|
|
158
|
+
the same lines in the same order, every count, bar, percentage, milestone row, list item and reminder
|
|
159
|
+
unchanged. Its section labels are bold lines, never `#` headings or `>` quotes, because the Codex
|
|
160
|
+
terminal prints those marks literally; add none. If the user writes in a third language, translate
|
|
161
|
+
the labels and plain words only, never a number, a bar, a title or a typed command. Add at most one
|
|
162
|
+
short line after it, only for a material risk the board does not already show.
|
|
163
|
+
|
|
164
|
+
The six sections, in order: `🎯 Do this now` (one plain action, one reason, and ``👉 Type: `go` ``,
|
|
165
|
+
``👉 Type: `lit approve` (optional) or `lit cancel` ``, `👉 Wait: …` or `👉 Do: …`), `📊 At a glance` (the overall
|
|
166
|
+
ten-cell bar with k/n and a whole percentage, then the ✅ done / 🔄 in progress / ⏳ waiting on you /
|
|
167
|
+
⬜ left table), `🏁 Milestones` (one row per plan or goal set with its bucket, bar and age, four at
|
|
168
|
+
most), `✅ Done lately` (five at most), `⬜ Still to do` (seven at most, then `…and N more`) and
|
|
169
|
+
`🔔 Don't forget` (five action-shaped reminders at most: `thing → what to do`). An empty section is
|
|
170
|
+
one plain line. The board holds no session id, commit hash, plan file name or raw status code; never
|
|
171
|
+
add one from the JSON.
|
|
172
|
+
|
|
173
|
+
# Step 2b - The detail list, only on request
|
|
174
|
+
With `--detail` the JSON also carries `detail`, the per-session draft. Put it under the board
|
|
175
|
+
unchanged; without `--detail`, never draw it yourself. It keeps this shape, with no `#` heading or
|
|
176
|
+
`>` quote mark, and ids, gauges, titles, dates and names copied from the JSON verbatim.
|
|
158
177
|
|
|
159
178
|
1. Opener, three bold lines: `✅ Done so far:` (finished plans, done sessions), `▶ Doing now:` (running, idle,
|
|
160
179
|
paused, what waits on the user) and `⏭ Next:` (the one next step), then a dim line with the window and session count.
|
|
@@ -166,8 +185,8 @@ translate it, and add no `#` heading or `>` quote mark (the Codex terminal print
|
|
|
166
185
|
4. One table under a `⚪ **Ended · N**` line: id, where, goal, ago, done, one row per ended session, eight at most, then the count
|
|
167
186
|
of the rest. Keep each row on one line.
|
|
168
187
|
5. One recommended next step in a box: `next` when its kind is not `none`, else `suggestion`, a real step from the
|
|
169
|
-
records. Say `go` for a resume-frame, continue-work or start-plan step, `lit approve` or `lit
|
|
170
|
-
|
|
188
|
+
records. Say `go` for a resume-frame, continue-work or start-plan step, `lit approve` (optional) or `lit cancel` for
|
|
189
|
+
parked steps a run counts (shown only; never type them for the user). A `handoff` step comes from this worktree's
|
|
171
190
|
HANDOFF note and `go` does not run it. A `suggestion` says nothing runs on its own here: open that session, or say
|
|
172
191
|
what to do; a done session is offered for review, never picked up again. Never write "no next step". The box
|
|
173
192
|
sits in a plain fence with no language tag.
|
|
@@ -109,7 +109,8 @@ export async function runUserPromptSubmitHookCli(stdin, stdout, stderr, repoRoot
|
|
|
109
109
|
return 0;
|
|
110
110
|
}
|
|
111
111
|
clearManagedCompactionWhenOff(hookCwd(parsed, repoRoot), auto.env ?? process.env);
|
|
112
|
-
// `lit approve` / `lit deny`
|
|
112
|
+
// `lit approve` / `lit deny` settle parked start-work steps and `lit cancel` ends the run; the lifecycle hook
|
|
113
|
+
// owns all three, so this one stays out.
|
|
113
114
|
if (isLitUserPromptSubmitInput(parsed) && isBoundaryAnswer(parsed.prompt))
|
|
114
115
|
return 0;
|
|
115
116
|
// `go` after a lit-adhd brief runs the one step the brief named, as if the user had typed that step.
|
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
export type Bucket = "done" | "doing" | "waiting" | "todo";
|
|
2
|
+
export type BoardLang = "en" | "ko";
|
|
3
|
+
/** Ten cells on every bar. */
|
|
4
|
+
export declare const BAR_CELLS = 10;
|
|
5
|
+
export declare const DONE_SHOWN = 5;
|
|
6
|
+
export declare const REMAINING_SHOWN = 7;
|
|
7
|
+
export declare const REMINDERS_SHOWN = 5;
|
|
8
|
+
export declare const MILESTONES_SHOWN = 4;
|
|
9
|
+
/** A plan nobody touched for this long is named as stopped. */
|
|
10
|
+
export declare const STALE_MS: number;
|
|
11
|
+
/** One plan as the board reads it: its title, its rows in order, and when its file last changed. */
|
|
12
|
+
export interface BoardPlanInput {
|
|
13
|
+
readonly title: string;
|
|
14
|
+
readonly file: string;
|
|
15
|
+
readonly rows: readonly {
|
|
16
|
+
readonly done: boolean;
|
|
17
|
+
readonly label: string;
|
|
18
|
+
}[];
|
|
19
|
+
readonly changedMs: number | null;
|
|
20
|
+
}
|
|
21
|
+
/** What the board needs from one worktree. */
|
|
22
|
+
export interface BoardTreeInput {
|
|
23
|
+
/** The worktree folder's name; shown, never its full path. */
|
|
24
|
+
readonly name: string;
|
|
25
|
+
/** Plans changed inside the window, open or finished. */
|
|
26
|
+
readonly plans: readonly BoardPlanInput[];
|
|
27
|
+
/** Open plans whose file has not changed for `STALE_MS` or longer. */
|
|
28
|
+
readonly stale: readonly {
|
|
29
|
+
readonly title: string;
|
|
30
|
+
readonly changedMs: number;
|
|
31
|
+
}[];
|
|
32
|
+
/** The plan file of the start-work run under way here, and its state. */
|
|
33
|
+
readonly work: {
|
|
34
|
+
readonly file: string;
|
|
35
|
+
readonly paused: boolean;
|
|
36
|
+
readonly parked: number;
|
|
37
|
+
} | null;
|
|
38
|
+
/** Steps the start-work run here parked; the run keeps going, and `lit approve` is optional. */
|
|
39
|
+
readonly parked: number;
|
|
40
|
+
readonly goals: {
|
|
41
|
+
readonly done: number;
|
|
42
|
+
readonly total: number;
|
|
43
|
+
} | null;
|
|
44
|
+
/** Changed or untracked files (`git status`); null when git could not say. */
|
|
45
|
+
readonly uncommitted: number | null;
|
|
46
|
+
/** Commits ahead of the upstream branch; null when there is no upstream or git could not say. */
|
|
47
|
+
readonly unpushed: number | null;
|
|
48
|
+
readonly handoffNext: string | null;
|
|
49
|
+
}
|
|
50
|
+
/** The step to take now, as data; `renderBoard` writes it in words. */
|
|
51
|
+
export type BoardNow = {
|
|
52
|
+
readonly kind: "resume";
|
|
53
|
+
readonly skill: string;
|
|
54
|
+
readonly stage: string | null;
|
|
55
|
+
} | {
|
|
56
|
+
readonly kind: "approve";
|
|
57
|
+
readonly place: string;
|
|
58
|
+
} | {
|
|
59
|
+
readonly kind: "continue";
|
|
60
|
+
readonly title: string;
|
|
61
|
+
readonly done: number | null;
|
|
62
|
+
readonly total: number | null;
|
|
63
|
+
} | {
|
|
64
|
+
readonly kind: "start";
|
|
65
|
+
readonly title: string;
|
|
66
|
+
readonly done: number;
|
|
67
|
+
readonly total: number;
|
|
68
|
+
} | {
|
|
69
|
+
readonly kind: "elsewhere";
|
|
70
|
+
} | {
|
|
71
|
+
readonly kind: "answer-lane";
|
|
72
|
+
readonly place: string;
|
|
73
|
+
readonly more: number;
|
|
74
|
+
} | {
|
|
75
|
+
readonly kind: "wait-lanes";
|
|
76
|
+
readonly place: string;
|
|
77
|
+
readonly count: number;
|
|
78
|
+
} | {
|
|
79
|
+
readonly kind: "handoff";
|
|
80
|
+
readonly item: string;
|
|
81
|
+
} | {
|
|
82
|
+
readonly kind: "answer";
|
|
83
|
+
readonly place: string;
|
|
84
|
+
readonly question: string | null;
|
|
85
|
+
} | {
|
|
86
|
+
readonly kind: "review";
|
|
87
|
+
readonly place: string;
|
|
88
|
+
readonly title: string;
|
|
89
|
+
} | {
|
|
90
|
+
readonly kind: "resume-other";
|
|
91
|
+
readonly label: string;
|
|
92
|
+
readonly place: string;
|
|
93
|
+
} | {
|
|
94
|
+
readonly kind: "plan-item";
|
|
95
|
+
readonly title: string;
|
|
96
|
+
readonly item: string;
|
|
97
|
+
} | {
|
|
98
|
+
readonly kind: "check";
|
|
99
|
+
readonly place: string;
|
|
100
|
+
readonly title: string;
|
|
101
|
+
} | {
|
|
102
|
+
readonly kind: "pick-up";
|
|
103
|
+
readonly place: string;
|
|
104
|
+
readonly title: string;
|
|
105
|
+
} | {
|
|
106
|
+
readonly kind: "nothing";
|
|
107
|
+
};
|
|
108
|
+
/** One reminder, as data: a fact the records show and what to do about it. */
|
|
109
|
+
export type BoardReminder = {
|
|
110
|
+
readonly kind: "waiting";
|
|
111
|
+
readonly place: string;
|
|
112
|
+
readonly question: string | null;
|
|
113
|
+
} | {
|
|
114
|
+
readonly kind: "parked";
|
|
115
|
+
readonly place: string;
|
|
116
|
+
readonly count: number;
|
|
117
|
+
} | {
|
|
118
|
+
readonly kind: "uncommitted";
|
|
119
|
+
readonly place: string;
|
|
120
|
+
readonly count: number;
|
|
121
|
+
} | {
|
|
122
|
+
readonly kind: "unpushed";
|
|
123
|
+
readonly place: string;
|
|
124
|
+
readonly count: number;
|
|
125
|
+
} | {
|
|
126
|
+
readonly kind: "lanes";
|
|
127
|
+
readonly count: number;
|
|
128
|
+
} | {
|
|
129
|
+
readonly kind: "stale";
|
|
130
|
+
readonly title: string;
|
|
131
|
+
readonly days: number;
|
|
132
|
+
} | {
|
|
133
|
+
readonly kind: "handoff";
|
|
134
|
+
readonly item: string;
|
|
135
|
+
};
|
|
136
|
+
export interface BoardMilestone {
|
|
137
|
+
readonly title: string;
|
|
138
|
+
readonly state: Bucket;
|
|
139
|
+
readonly done: number;
|
|
140
|
+
readonly total: number;
|
|
141
|
+
readonly bar: string;
|
|
142
|
+
readonly lastMs: number | null;
|
|
143
|
+
}
|
|
144
|
+
export interface BoardCounts {
|
|
145
|
+
readonly done: number;
|
|
146
|
+
readonly doing: number;
|
|
147
|
+
readonly waiting: number;
|
|
148
|
+
readonly todo: number;
|
|
149
|
+
readonly total: number;
|
|
150
|
+
/** Whole percent of `total` that is done; 0 when nothing is tracked. */
|
|
151
|
+
readonly percent: number;
|
|
152
|
+
readonly bar: string;
|
|
153
|
+
}
|
|
154
|
+
export interface RewindBoard {
|
|
155
|
+
readonly at: number;
|
|
156
|
+
readonly now: BoardNow;
|
|
157
|
+
/** How the person takes the step: type a word, wait for a lane, or do something by hand. */
|
|
158
|
+
readonly take: "go" | "approve" | "wait" | "do";
|
|
159
|
+
readonly counts: BoardCounts;
|
|
160
|
+
readonly milestones: readonly BoardMilestone[];
|
|
161
|
+
readonly doneLately: readonly string[];
|
|
162
|
+
readonly remaining: readonly string[];
|
|
163
|
+
/** Remaining rows past the ones listed. */
|
|
164
|
+
readonly remainingMore: number;
|
|
165
|
+
readonly reminders: readonly BoardReminder[];
|
|
166
|
+
/** Sources that could not be read, named once under the board. */
|
|
167
|
+
readonly unknown: readonly string[];
|
|
168
|
+
}
|
|
169
|
+
export interface BoardInput {
|
|
170
|
+
readonly now: number;
|
|
171
|
+
readonly step: BoardNow;
|
|
172
|
+
/** Trees in order, the asking folder's first. */
|
|
173
|
+
readonly trees: readonly BoardTreeInput[];
|
|
174
|
+
/** Places of sessions that wait on the person, newest first, with their last question when there is one. */
|
|
175
|
+
readonly waiting: readonly {
|
|
176
|
+
readonly place: string;
|
|
177
|
+
readonly question: string | null;
|
|
178
|
+
}[];
|
|
179
|
+
/** Other lanes still at work, not counting the ones that wait on the person. */
|
|
180
|
+
readonly working: number;
|
|
181
|
+
readonly unknown: readonly string[];
|
|
182
|
+
}
|
|
183
|
+
/** Ten cells of `█` and `░`; a partly done total never draws as full or as empty. */
|
|
184
|
+
export declare function boardBar(done: number, total: number): string;
|
|
185
|
+
export declare function boardPercent(done: number, total: number): number;
|
|
186
|
+
export declare function buildBoard(input: BoardInput): RewindBoard;
|
|
187
|
+
/**
|
|
188
|
+
* The board as Markdown the Codex terminal draws: bold section lines (it prints `#` heading marks literally),
|
|
189
|
+
* emoji, two tables and lists. Fixed order: do this now, at a glance, milestones, done lately, still to do,
|
|
190
|
+
* don't forget. About forty lines at most; every empty section says so in one line.
|
|
191
|
+
*/
|
|
192
|
+
export declare function renderBoard(board: RewindBoard, lang?: BoardLang): string;
|