@litfamily/litgravity 0.1.0 → 0.1.1
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/CHANGELOG.md +5 -0
- package/README.md +58 -17
- package/README_ko-KR.md +56 -15
- package/package.json +1 -1
- package/plugin/plugin.json +1 -1
- package/plugin/skills/readme-studio/templates/hyperframes-cover/package-lock.json +3 -3
- package/plugin/skills/readme-studio/templates/remotion-cover/package-lock.json +3 -3
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,10 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.1.1 — 2026-10-26
|
|
4
|
+
|
|
5
|
+
- The README studio's HyperFrames and Remotion cover templates pin newer `hono` and `fast-uri` in their lockfiles, picking up upstream fixes. A fresh template setup installs these versions.
|
|
6
|
+
- Both READMEs are rewritten with real captures of the install check, the status line states, a held handoff and a short demo, plus overview tables. The images stay in the repository, so the npm page loads them from GitHub.
|
|
7
|
+
|
|
3
8
|
## 0.1.0 — 2026-10-22
|
|
4
9
|
|
|
5
10
|
First release of LitGravity, the LitFamily member for Google's Antigravity CLI (probed on agy 1.4.3).
|
package/README.md
CHANGED
|
@@ -12,7 +12,13 @@
|
|
|
12
12
|
<a href="https://github.com/wjgoarxiv/litgravity/stargazers"><img src="https://img.shields.io/github/stars/wjgoarxiv/litgravity?style=flat" alt="GitHub stars" /></a>
|
|
13
13
|
</p>
|
|
14
14
|
|
|
15
|
-
<p align="center"><a href="#install"
|
|
15
|
+
<p align="center"><a href="#install"><img src="./docs/assets/readme/icon-book.svg" width="16" alt="" /> Install</a> <a href="#demo"><img src="./docs/assets/readme/icon-play.svg" width="16" alt="" /> Demo</a> <a href="#safety-and-uninstall"><img src="./docs/assets/readme/icon-shield.svg" width="16" alt="" /> Safety</a> <a href="#quick-start">Quick start</a> <a href="#what-you-get">What you get</a> <a href="#what-agy-limits-today">agy limits</a> <a href="./README_ko-KR.md">한국어</a></p>
|
|
16
|
+
|
|
17
|
+
## Demo
|
|
18
|
+
|
|
19
|
+
What ignition looks like, captured from the real hook and status line on this Mac: the typed prompt, the injected route note, and the status line carrying the lit-loop map.
|
|
20
|
+
|
|
21
|
+
<!-- demo-gif --><p align="center"><img src="./docs/assets/litgravity/demo-ignition.webp" width="960" alt="Terminal capture. The prompt reads lit add a --shout flag that prints the greeting in capitals, with a test. The hook answers with the LIT mark and LIT IGNITED · lit-loop, names the lit-loop skill file to read first, and notes that tool events go to the conversation ledger. Below, the status line shows the model, the context gauge at 42 percent, the lit-loop chip with its clock, and the PIN through RECORD map with PIN lit." /></p>
|
|
16
22
|
|
|
17
23
|
## Why LitGravity
|
|
18
24
|
|
|
@@ -26,7 +32,13 @@ it does reads the plan skill, explores the repo, writes plans/todo-app.md wi
|
|
|
26
32
|
it ends "Plan saved. Run `lit start plans/todo-app.md` when you are happy with it."
|
|
27
33
|
```
|
|
28
34
|
|
|
29
|
-
agy still runs the conversation and picks the model
|
|
35
|
+
agy still runs the conversation and picks the model, while LitGravity adds the routine around it. That routine lives in plain files you can read:
|
|
36
|
+
|
|
37
|
+
| What agy does | What lit adds |
|
|
38
|
+
|---|---|
|
|
39
|
+
| Starts from one typed line | A plan in `plans/` before the first edit |
|
|
40
|
+
| Forgets the last conversation | Checks against the plan, marks the unchecked as unverified |
|
|
41
|
+
| Calls it done when the model says so | A handoff in `.litgravity/` the next turn reads |
|
|
30
42
|
|
|
31
43
|
## Install
|
|
32
44
|
|
|
@@ -44,6 +56,8 @@ npx @litfamily/litgravity doctor
|
|
|
44
56
|
|
|
45
57
|
`doctor` lists the installed copy, the validation result, the six hook events and a smoke run of each hook script, every skill and agent, every engine with its pre-warm command, the host programs the skills call, and the Python the engines will use. It ends with `LitGravity: ready` when nothing is broken.
|
|
46
58
|
|
|
59
|
+
<p align="center"><img src="./docs/assets/litgravity/install-doctor.webp" width="960" alt="Terminal capture. The install command ends with Status: Ready, and the doctor command ends with LitGravity: ready after thirty passing checks." /></p>
|
|
60
|
+
|
|
47
61
|
Useful switches: `--dry-run` previews and writes nothing; `--yes` lets an agent or CI shell install (a shell without a terminal otherwise only previews); `--status-line` adds the optional LitGravity status line to agy's user settings (never on by default).
|
|
48
62
|
|
|
49
63
|
The status line is one row under the prompt, drawn in the LitFamily status-line style: the `[🔥LIT v…]` mark, then every segment in LitGravity's flame orange. It reads `model [effort] │ ctx [█▎░] 42%/1049k │ quota [▌░]28% ↻ 2h5m`, then the active lit route as a pink `🔥 LIT` chip with its clock, then where the route stands on its map (PIN, RED, GREEN, VERIFY, REVIEW, RECORD for the open criterion of litwork and lit-loop, read from its evidence files; interview, plan, work, review, done for planning and start-work, with the plan's rows), the lanes of a lit-team, and whatever agy also reports: cost, background tasks, the branch and the title. The context and quota gauges turn yellow at 70% and red at 90%. On a narrow terminal the extras go first and the route and the context gauge stay. `NO_COLOR` turns colour off and `LITGRAVITY_HUD_ASCII=1` keeps every glyph ASCII. If agy already shows another status line, the installer refuses to touch it; `install --status-line --replace-status-line` swaps it after saving the old value, and `uninstall` puts that value back.
|
|
@@ -71,22 +85,31 @@ Use only the official npm package @litfamily/litgravity. Show me your plan and w
|
|
|
71
85
|
|
|
72
86
|
`npx @litfamily/litgravity list` prints every skill with the words that reach it. A `lit` while its route is already active gets a short "continues" note, `lit <other route>` switches, a bare `lit` picks up a plan you started with `lit start`, and `lit new` starts over.
|
|
73
87
|
|
|
88
|
+
## The status line
|
|
89
|
+
|
|
90
|
+
One row under the prompt shows where the work stands: the model and its effort tier, the context and quota gauges, the active route with its clock, and the map of that route with the current stage lit. The capture below is a real render from this Mac, before and after a `lit` prompt.
|
|
91
|
+
|
|
92
|
+
<p align="center"><img src="./docs/assets/litgravity/status-states.webp" width="960" alt="Terminal capture of the status line. Before lit it shows the model and the context gauge at 42 percent. After lit it adds the lit-loop chip with its clock and the PIN through RECORD map with PIN lit." /></p>
|
|
93
|
+
|
|
94
|
+
When the terminal narrows, the extras give way first and the route and the context gauge stay. Where colour is off, the same row renders in plain text:
|
|
95
|
+
|
|
96
|
+
```text
|
|
97
|
+
[LIT] | GF3.8 | ctx [#--] 42%/1049k | [LIT] . lit-loop 2:20 | [PIN] = RED . - GREEN . - VERIFY . - REVIEW . - RECORD .
|
|
98
|
+
```
|
|
99
|
+
|
|
74
100
|
## What you get
|
|
75
101
|
|
|
76
|
-
**39 skills**, each a dense agy skill read on demand, with the references, scripts, templates and engines it needs inside its own folder. agy loads only the first 24,000 bytes of a `SKILL.md`, so the long material sits in the skill's `references/` folder and the skill names the file to open
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
- Documents and figures: lit-docx, lit-pptx, lit-scientific-visualization, lit-diagram-drawer
|
|
88
|
-
- Film and covers: lit-typographic-motion (short films, kinetic type, lyric videos and seamless README cover loops, each rendered by a deterministic renderer, gated on the decoded file and looked at frame by frame)
|
|
89
|
-
- Tools: structural-search, browser-drive
|
|
102
|
+
**39 skills**, each a dense agy skill read on demand, with the references, scripts, templates and engines it needs inside its own folder. agy loads only the first 24,000 bytes of a `SKILL.md`, so the long material sits in the skill's `references/` folder and the skill names the file to open.
|
|
103
|
+
|
|
104
|
+
A lit turn runs the same routine through these parts. A bigger change gets a written plan first, the work is built row by row with tests under a goal record that outlives one conversation, a second look reviews it before anything merges, research shows its sources, documents and prose read clean, and the turn ends with a handoff the next conversation reads:
|
|
105
|
+
|
|
106
|
+
| Part | Contents | Role |
|
|
107
|
+
|---|---|---|
|
|
108
|
+
| 39 skills | Dense agy skills with their references, scripts and engines | Plan, build, check, research, write, hand off |
|
|
109
|
+
| 11 agents | Child agents agy starts under their type names | Plan, execute, verify, review, Korean prose |
|
|
110
|
+
| 6 hooks | Run at session start, each turn, each tool call, and the stop gate | Route `lit`, hold unfinished turns, ledger every tool |
|
|
111
|
+
|
|
112
|
+
agy loads only the first 24,000 bytes of a `SKILL.md`, so the long material sits in the skill's `references/` folder and the skill names the file to open. The skill groups are loop and goals, ideas and planning, building, review and cleanup, research and knowledge, teams, prose, continuity and guidance, interface and docs, documents and figures, film and covers, and tools; `npx @litfamily/litgravity list` prints every skill with the words that reach it.
|
|
90
113
|
|
|
91
114
|
The document, diagram, README-cover, figure and motion skills ship pinned engines: `office`, `diagram`, `readme`, `sciviz` and `motion`. Each installs into `~/.local/share/litgravity/runtime/<name>` and nowhere else. Install them once with `npx @litfamily/litgravity runtime install all` (or one name); `runtime status` shows each one. A skill checks its engine first and asks agy to run the install command when it is missing. Engines that need Python pick a supported interpreter by themselves: a `python3` newer than 3.14 has no wheels for the pinned packages, so they walk to `python3.14`, `python3.13` and so on, honour `LITGRAVITY_OFFICE_PYTHON`, `LITGRAVITY_SCIVIZ_PYTHON` or `LITGRAVITY_MOTION_PYTHON`, and answer `BLOCKED` with the exact fix when no interpreter fits. The skills also call programs already on your machine: LibreOffice, pandoc, Poppler, Chrome or Chromium, ffmpeg, libwebp, ast-grep, XeLaTeX and the language checkers that `lsp` drives. `doctor` names what is missing and the command that installs it; LitGravity never installs software globally.
|
|
92
115
|
|
|
@@ -123,6 +146,14 @@ These are the facts of agy 1.4.3, probed on a real install. LitGravity works ins
|
|
|
123
146
|
|
|
124
147
|
Route state lives outside the project, under `~/.local/state/litgravity/`, away from the files a planning turn is asked to touch. If that state is damaged, the child-agent limit and the plan gate stay on; if it goes missing, the hooks fall back to the route journal kept beside it.
|
|
125
148
|
|
|
149
|
+
## Held turns and the ledger
|
|
150
|
+
|
|
151
|
+
Some turns are allowed to wait. A lit-plan turn with no plan file yet is held at the end until `plans/<slug>.md` exists, at most three holds in a row without progress. Start-work waits while an approved plan has open rows, and litgoal and lit-loop wait while a goal record has an open criterion. Say `pause`, or write `BLOCKED at row N:`, `PAUSED at row N:` or `CANCELLED:` in the ledger, to release a hold. The capture below is the real hold from a planning turn that wrote nothing.
|
|
152
|
+
|
|
153
|
+
<p align="center"><img src="./docs/assets/litgravity/handoff-hold.webp" width="960" alt="Terminal capture. After the prompt lit plan a tiny todo app with no plan file written, the Stop hook answers decision continue with the lit-plan gate reason asking for the plan file. A second block shows a ledger line recording a read_file tool call." /></p>
|
|
154
|
+
|
|
155
|
+
While a route is active, every tool call lands in `.litgravity/ledger/<conversation>.jsonl` with key shapes redacted, one line per call. Before you stop, `lit handoff` writes `.litgravity/handoff/latest.md` with what was built, how it was checked and what is left, so the next conversation starts from that note.
|
|
156
|
+
|
|
126
157
|
## Safety and uninstall
|
|
127
158
|
|
|
128
159
|
- The installer writes only its own plugin folder, its data directory (`$XDG_DATA_HOME/litgravity`) and, when you ask, the status line key in agy's user settings, after a backup. It never reads agy's credential files.
|
|
@@ -130,7 +161,17 @@ Route state lives outside the project, under `~/.local/state/litgravity/`, away
|
|
|
130
161
|
- Hooks fail open: if one breaks, your conversation continues.
|
|
131
162
|
- Engine caches live under `~/.local/share/litgravity/runtime/`. `uninstall` keeps them, so delete that folder to free the space.
|
|
132
163
|
- Set `LITGRAVITY_HOOK_TRACE=<file>` before starting agy to log one line per hook call. It is off otherwise.
|
|
133
|
-
|
|
164
|
+
Three commands cover the lifecycle, and every one previews with `--dry-run`:
|
|
165
|
+
|
|
166
|
+
| Task | Command |
|
|
167
|
+
|---|---|
|
|
168
|
+
| Install | `npx @litfamily/litgravity install` |
|
|
169
|
+
| Update | `npx @litfamily/litgravity install` (validates, replaces in place) |
|
|
170
|
+
| Refresh engines | `npx @litfamily/litgravity runtime install all` |
|
|
171
|
+
| Check | `npx @litfamily/litgravity doctor` |
|
|
172
|
+
| Remove | `npx @litfamily/litgravity uninstall --yes` |
|
|
173
|
+
|
|
174
|
+
Files that conversations created in your projects (`plans/`, `.litgravity/`) stay where they are.
|
|
134
175
|
|
|
135
176
|
## Family
|
|
136
177
|
|
package/README_ko-KR.md
CHANGED
|
@@ -12,7 +12,13 @@
|
|
|
12
12
|
<a href="https://github.com/wjgoarxiv/litgravity/stargazers"><img src="https://img.shields.io/github/stars/wjgoarxiv/litgravity?style=flat" alt="GitHub 스타" /></a>
|
|
13
13
|
</p>
|
|
14
14
|
|
|
15
|
-
<p align="center"><a href="#설치"
|
|
15
|
+
<p align="center"><a href="#설치"><img src="./docs/assets/readme/icon-book.svg" width="16" alt="" /> 설치</a> <a href="#데모"><img src="./docs/assets/readme/icon-play.svg" width="16" alt="" /> 데모</a> <a href="#안전과-제거"><img src="./docs/assets/readme/icon-shield.svg" width="16" alt="" /> 안전</a> <a href="#빠른-시작">빠른 시작</a> <a href="#들어-있는-것">들어 있는 것</a> <a href="#지금-agy가-막아-두는-것">agy의 한계</a> <a href="./README.md">English</a></p>
|
|
16
|
+
|
|
17
|
+
## 데모
|
|
18
|
+
|
|
19
|
+
`lit`을 치면 무엇이 도는지, 이 Mac의 실제 훅과 상태 표시줄에서 가져왔습니다. 친 프롬프트, 끼워 넣은 경로 안내, lit-loop 지도를 단 상태 표시줄 순서입니다.
|
|
20
|
+
|
|
21
|
+
<!-- demo-gif --><p align="center"><img src="./docs/assets/litgravity/demo-ignition.webp" width="960" alt="터미널 갈무리. 프롬프트는 lit add a --shout flag that prints the greeting in capitals, with a test. 훅은 LIT 표시와 LIT IGNITED · lit-loop로 답하고, 먼저 읽을 lit-loop 스킬 파일을 알리고, 도구 기록이 대화 ledger에 남는다고 안내합니다. 아래 상태 표시줄에는 모델, 42퍼센트 컨텍스트 게이지, 시계가 달린 lit-loop 칩, PIN이 켜진 PIN부터 RECORD까지의 지도가 보입니다." /></p>
|
|
16
22
|
|
|
17
23
|
## 왜 LitGravity인가
|
|
18
24
|
|
|
@@ -26,7 +32,13 @@ LitGravity는 대화마다 따라갈 순서를 줍니다. 프롬프트를 `lit`
|
|
|
26
32
|
마무리 "계획을 저장했습니다. 괜찮으면 `lit start plans/todo-app.md`를 실행하세요."
|
|
27
33
|
```
|
|
28
34
|
|
|
29
|
-
대화를 돌리고 모델을 고르는 것은 여전히 agy
|
|
35
|
+
대화를 돌리고 모델을 고르는 것은 여전히 agy이고, LitGravity는 그 주위에 따라갈 순서를 더합니다. 그 순서는 직접 읽을 수 있는 평범한 파일로 남습니다.
|
|
36
|
+
|
|
37
|
+
| agy가 하는 일 | lit이 더하는 일 |
|
|
38
|
+
|---|---|
|
|
39
|
+
| 한 줄을 치면 시작합니다 | 첫 편집 전에 `plans/`에 계획을 적습니다 |
|
|
40
|
+
| 지난 대화를 잊습니다 | 계획에 맞춰 확인하고, 확인하지 못한 곳은 미확인으로 표시합니다 |
|
|
41
|
+
| 모델이 그렇다고 하면 끝냅니다 | 다음 턴이 읽을 `.litgravity/` 인계를 남깁니다 |
|
|
30
42
|
|
|
31
43
|
## 설치
|
|
32
44
|
|
|
@@ -44,6 +56,8 @@ npx @litfamily/litgravity doctor
|
|
|
44
56
|
|
|
45
57
|
`doctor`는 설치된 사본, 검증 결과, 훅 이벤트 6개와 각 훅 스크립트의 실행 확인, 스킬과 에이전트 전체, 각 엔진과 그 사전 설치 명령, 스킬이 부르는 호스트 프로그램, 엔진이 쓸 Python을 보여 줍니다. 깨진 곳이 없으면 마지막 줄이 `LitGravity: ready`입니다.
|
|
46
58
|
|
|
59
|
+
<p align="center"><img src="./docs/assets/litgravity/install-doctor.webp" width="960" alt="터미널 갈무리. 설치 명령은 Status: Ready로 끝나고, doctor 명령은 서른 개의 통과 확인 뒤에 LitGravity: ready로 끝납니다." /></p>
|
|
60
|
+
|
|
47
61
|
자주 쓰는 옵션: `--dry-run`은 미리 보기만 하고 아무것도 쓰지 않습니다. `--yes`는 터미널이 붙지 않은 에이전트나 CI 셸에서 설치를 허용합니다(그런 셸에서는 기본으로 미리 보기만 합니다). `--status-line`은 agy 사용자 설정에 선택형 LitGravity 상태 표시줄을 추가합니다(기본값은 꺼짐).
|
|
48
62
|
|
|
49
63
|
상태 표시줄은 프롬프트 아래 한 줄이고, LitFamily 상태 표시줄 모양을 따릅니다. `[🔥LIT v…]` 표시 뒤의 모든 칸은 LitGravity의 불꽃 주황 한 가지 색입니다. 순서는 `model [effort] │ ctx [█▎░] 42%/1049k │ quota [▌░]28% ↻ 2h5m`이고, 그 뒤에 지금 도는 lit 경로를 분홍 `🔥 LIT` 칩과 시계로, 그 경로가 지도에서 어디쯤인지를 보여 줍니다. litwork와 lit-loop는 열린 기준의 증거 파일을 읽어 PIN, RED, GREEN, VERIFY, REVIEW, RECORD 중 하나를, 계획과 start-work는 interview, plan, work, review, done 중 하나를 계획 행 수와 함께 보여 줍니다. lit-team은 레인을 보여 주고, agy가 함께 넘겨주는 비용, 백그라운드 작업, 브랜치, 제목이 이어집니다. 컨텍스트와 쿼터 게이지는 70%에서 노랑, 90%에서 빨강이 됩니다. 터미널이 좁으면 덧붙인 정보부터 빠지고 경로와 컨텍스트 게이지는 남습니다. `NO_COLOR`는 색을 끄고, `LITGRAVITY_HUD_ASCII=1`은 모든 기호를 ASCII로 바꿉니다. agy에 이미 다른 상태 표시줄이 있으면 설치기는 손대지 않습니다. `install --status-line --replace-status-line`을 쓰면 원래 값을 저장한 뒤 바꾸고, `uninstall`이 그 값을 되돌려 놓습니다.
|
|
@@ -71,22 +85,31 @@ Google Antigravity CLI용 LitFamily 플러그인인 LitGravity를 설치해 줘.
|
|
|
71
85
|
|
|
72
86
|
`npx @litfamily/litgravity list`는 모든 스킬과 그 스킬에 닿는 단어를 출력합니다. 경로가 이미 켜진 상태에서 `lit`을 다시 쓰면 짧은 "이어 갑니다" 메모만 가고, `lit <다른 경로>`는 경로를 바꾸며, `lit`만 쓰면 `lit start`로 시작해 둔 계획을 이어받고, `lit new`는 처음부터 다시 시작합니다.
|
|
73
87
|
|
|
88
|
+
## 상태 표시줄
|
|
89
|
+
|
|
90
|
+
프롬프트 아래 한 줄이 지금 작업이 어디쯤인지 보여 줍니다. 모델과 강도, 컨텍스트와 쿼터 게이지, 시계가 달린 지금 경로, 현재 단계가 켜진 경로 지도 순서입니다. 아래 갈무리는 이 Mac에서 실제로 렌더링한 것으로, `lit`을 치기 전과 친 뒤입니다.
|
|
91
|
+
|
|
92
|
+
<p align="center"><img src="./docs/assets/litgravity/status-states.webp" width="960" alt="상태 표시줄의 터미널 갈무리. lit 전에는 모델과 42퍼센트 컨텍스트 게이지만 보이고, lit 뒤에는 시계가 달린 lit-loop 칩과 PIN이 켜진 PIN부터 RECORD까지의 지도가 덧붙습니다." /></p>
|
|
93
|
+
|
|
94
|
+
터미널이 좁아지면 덧붙는 정보부터 빠지고 경로와 컨텍스트 게이지는 남습니다. 색이 꺼진 곳에서는 같은 줄이 다음처럼 평문으로 나옵니다.
|
|
95
|
+
|
|
96
|
+
```text
|
|
97
|
+
[LIT] | GF3.8 | ctx [#--] 42%/1049k | [LIT] . lit-loop 2:20 | [PIN] = RED . - GREEN . - VERIFY . - REVIEW . - RECORD .
|
|
98
|
+
```
|
|
99
|
+
|
|
74
100
|
## 들어 있는 것
|
|
75
101
|
|
|
102
|
+
모든 lit 턴은 같은 순서를 따릅니다. 큰 변경은 첫 편집 전에 계획으로 적습니다. 작업은 그 계획에 맞춰 테스트와 실제 화면 확인으로 검증합니다. 합치기 전에는 두 번째 눈이 검토합니다. 조사는 출처를 밝히고, 문서와 글은 깔끔하게 읽히며, 턴은 다음 대화가 읽을 인계 메모로 끝납니다. 아래 스킬, 에이전트, 훅, 엔진은 그 순서의 부품으로, 필요할 때 읽습니다.
|
|
103
|
+
|
|
76
104
|
**스킬 39개.** 각 스킬은 필요할 때 읽는 agy 스킬로, 필요한 참고 문서, 스크립트, 템플릿, 엔진을 자기 폴더 안에 갖고 있습니다. agy는 `SKILL.md`의 앞 24,000바이트만 불러오므로 긴 내용은 스킬의 `references/` 폴더에 두고, 스킬이 열 파일을 알려 줍니다.
|
|
77
105
|
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
- 이어가기와 안내: lit-recap, lit-handoff, lit-init, rules
|
|
86
|
-
- 화면과 문서: frontend-ui-ux, readme-studio
|
|
87
|
-
- 문서와 그림: lit-docx, lit-pptx, lit-scientific-visualization, lit-diagram-drawer
|
|
88
|
-
- 영상과 커버: lit-typographic-motion (짧은 영상, 키네틱 타이포, 가사 영상, 끊김 없는 README 커버 루프. 결정적 렌더러로 만들고, 디코딩한 파일로 게이트를 통과시키고, 프레임을 하나씩 눈으로 봅니다)
|
|
89
|
-
- 도구: structural-search, browser-drive
|
|
106
|
+
| 부분 | 내용 | 역할 |
|
|
107
|
+
|---|---|---|
|
|
108
|
+
| 스킬 39개 | 참고 문서, 스크립트, 엔진을 담은 agy 스킬 | 계획, 구현, 확인, 조사, 작성, 인계 |
|
|
109
|
+
| 에이전트 11개 | agy가 타입 이름으로 시작하는 하위 에이전트 | 계획, 실행, 검증, 검토, 한국어 글 |
|
|
110
|
+
| 훅 6개 | 세션 시작, 매 턴, 매 도구 호출, 종료 게이트에서 실행 | `lit` 라우팅, 미완 턴 붙잡기, 도구 ledger 기록 |
|
|
111
|
+
|
|
112
|
+
스킬 묶음은 루프와 목표, 아이디어와 계획, 구현, 검토와 정리, 조사와 지식, 팀, 글, 이어가기와 안내, 화면과 문서, 문서와 그림, 영상과 커버, 도구이고, `npx @litfamily/litgravity list`는 모든 스킬과 그 스킬에 닿는 단어를 출력합니다.
|
|
90
113
|
|
|
91
114
|
문서, 다이어그램, README 커버, 그림, 모션 스킬은 버전이 고정된 엔진을 함께 싣습니다. 이름은 `office`, `diagram`, `readme`, `sciviz`, `motion`입니다. 각 엔진은 `~/.local/share/litgravity/runtime/<이름>`에만 설치됩니다. `npx @litfamily/litgravity runtime install all`(또는 이름 하나)로 한 번 설치하고, `runtime status`로 상태를 봅니다. 스킬은 엔진이 준비됐는지 먼저 확인하고, 없으면 agy에 설치 명령을 실행해 달라고 합니다. Python이 필요한 엔진은 알아서 쓸 수 있는 인터프리터를 고릅니다. 3.14보다 새로운 `python3`에는 고정된 패키지의 휠이 없으므로 `python3.14`, `python3.13`을 차례로 찾고, `LITGRAVITY_OFFICE_PYTHON`, `LITGRAVITY_SCIVIZ_PYTHON`, `LITGRAVITY_MOTION_PYTHON`이 있으면 그 값을 따르며, 맞는 인터프리터가 없으면 정확한 해결 방법과 함께 `BLOCKED`로 답합니다. 스킬은 이미 설치된 프로그램도 부릅니다. LibreOffice, pandoc, Poppler, Chrome 또는 Chromium, ffmpeg, libwebp, ast-grep, XeLaTeX, `lsp`가 돌리는 언어별 검사기가 그것입니다. 빠진 것과 설치 명령은 `doctor`가 알려 주며, LitGravity는 소프트웨어를 전역으로 설치하지 않습니다.
|
|
92
115
|
|
|
@@ -123,6 +146,14 @@ Google Antigravity CLI용 LitFamily 플러그인인 LitGravity를 설치해 줘.
|
|
|
123
146
|
|
|
124
147
|
경로 상태는 프로젝트 밖의 `~/.local/state/litgravity/`에 있어서, 계획 턴이 다루라고 안내받는 파일과 떨어져 있습니다. 그 상태가 손상되면 하위 에이전트 제한과 계획 게이트는 켜진 채로 남고, 사라지면 훅이 옆에 둔 경로 기록을 대신 읽습니다.
|
|
125
148
|
|
|
149
|
+
## 붙잡힌 턴과 ledger
|
|
150
|
+
|
|
151
|
+
기다려도 되는 턴이 있습니다. 계획 파일이 아직 없는 lit-plan 턴은 `plans/<slug>.md`가 생길 때까지 끝에서 붙잡히며, 진전 없이 연달아 최대 세 번입니다. start-work는 승인된 계획에 열린 행이 있는 동안, litgoal과 lit-loop는 목표 기록에 열린 기준이 있는 동안 기다립니다. `pause`라고 말하거나 ledger에 `BLOCKED at row N:`, `PAUSED at row N:`, `CANCELLED:`를 적으면 풀립니다. 아래 갈무리는 아무것도 쓰지 않은 계획 턴이 실제로 붙잡힌 모습입니다.
|
|
152
|
+
|
|
153
|
+
<p align="center"><img src="./docs/assets/litgravity/handoff-hold.webp" width="960" alt="터미널 갈무리. 계획 파일 없이 끝난 lit plan a tiny todo app 프롬프트 뒤에 Stop 훅이 decision continue와 계획 파일을 요구하는 lit-plan 게이트 사유로 답합니다. 아래쪽에는 read_file 도구 호출을 기록한 ledger 한 줄이 보입니다." /></p>
|
|
154
|
+
|
|
155
|
+
경로가 켜져 있는 동안 모든 도구 호출은 `.litgravity/ledger/<대화>.jsonl`에 한 줄씩 남고, 키 모양의 값은 가려집니다. 멈추기 전에 `lit handoff`를 치면 무엇을 만들었고 어떻게 확인했고 무엇이 남았는지 `.litgravity/handoff/latest.md`에 적히고, 다음 대화는 그 메모에서 시작합니다.
|
|
156
|
+
|
|
126
157
|
## 안전과 제거
|
|
127
158
|
|
|
128
159
|
- 설치기는 자기 플러그인 폴더, 데이터 디렉터리(`$XDG_DATA_HOME/litgravity`), 그리고 요청했을 때 agy 사용자 설정의 상태 표시줄 키만 씁니다. 설정 파일은 먼저 백업합니다. agy의 인증 파일은 읽지 않습니다.
|
|
@@ -130,7 +161,17 @@ Google Antigravity CLI용 LitFamily 플러그인인 LitGravity를 설치해 줘.
|
|
|
130
161
|
- 훅이 하나 깨져도 대화는 계속됩니다.
|
|
131
162
|
- 엔진 캐시는 `~/.local/share/litgravity/runtime/`에 있습니다. `uninstall`은 캐시를 남기므로, 공간이 필요하면 그 폴더를 지우세요.
|
|
132
163
|
- agy를 시작하기 전에 `LITGRAVITY_HOOK_TRACE=<파일>`을 지정하면 훅 호출마다 한 줄씩 기록합니다. 지정하지 않으면 꺼져 있습니다.
|
|
133
|
-
|
|
164
|
+
설치부터 제거까지 세 명령으로 충분하고, 모두 `--dry-run`으로 먼저 미리 봅니다.
|
|
165
|
+
|
|
166
|
+
| 작업 | 명령 |
|
|
167
|
+
|---|---|
|
|
168
|
+
| 설치 | `npx @litfamily/litgravity install` |
|
|
169
|
+
| 업데이트 | `npx @litfamily/litgravity install` (검증하고 그 자리에서 교체) |
|
|
170
|
+
| 엔진 새로 받기 | `npx @litfamily/litgravity runtime install all` |
|
|
171
|
+
| 확인 | `npx @litfamily/litgravity doctor` |
|
|
172
|
+
| 제거 | `npx @litfamily/litgravity uninstall --yes` |
|
|
173
|
+
|
|
174
|
+
대화가 프로젝트에 만든 파일(`plans/`, `.litgravity/`)은 그대로 남습니다.
|
|
134
175
|
|
|
135
176
|
## 패밀리
|
|
136
177
|
|
package/package.json
CHANGED
package/plugin/plugin.json
CHANGED
|
@@ -2,5 +2,5 @@
|
|
|
2
2
|
"$schema": "https://antigravity.google/schemas/v1/plugin.json",
|
|
3
3
|
"name": "litgravity",
|
|
4
4
|
"description": "LitFamily workflows for the Antigravity CLI: bare lit activation, planning, evidence-bound execution, review, research, handoff and Korean prose care.",
|
|
5
|
-
"version": "0.1.
|
|
5
|
+
"version": "0.1.1"
|
|
6
6
|
}
|
|
@@ -1466,9 +1466,9 @@
|
|
|
1466
1466
|
}
|
|
1467
1467
|
},
|
|
1468
1468
|
"node_modules/hono": {
|
|
1469
|
-
"version": "4.13.
|
|
1470
|
-
"resolved": "https://registry.npmjs.org/hono/-/hono-4.13.
|
|
1471
|
-
"integrity": "sha512
|
|
1469
|
+
"version": "4.13.13",
|
|
1470
|
+
"resolved": "https://registry.npmjs.org/hono/-/hono-4.13.13.tgz",
|
|
1471
|
+
"integrity": "sha512-CQ46U0ZkAGmbT/4UxdzzGJpacP2IeKgY4a5/tOI9AABbpOMfK739wfDXmv1usCk+3RkKj1hQy4/fjhiwa2xlrA==",
|
|
1472
1472
|
"dev": true,
|
|
1473
1473
|
"license": "MIT",
|
|
1474
1474
|
"engines": {
|
|
@@ -2582,9 +2582,9 @@
|
|
|
2582
2582
|
"license": "MIT"
|
|
2583
2583
|
},
|
|
2584
2584
|
"node_modules/fast-uri": {
|
|
2585
|
-
"version": "3.1.
|
|
2586
|
-
"resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.
|
|
2587
|
-
"integrity": "sha512-
|
|
2585
|
+
"version": "3.1.9",
|
|
2586
|
+
"resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.9.tgz",
|
|
2587
|
+
"integrity": "sha512-hS/0Wt3Ya043oKXs0sIxrMpKQITXhMLIrVAKKXi4gozGC9v7YRWVnXIZzjNPTO02M9BdxLCWqK1yRXgNziVyJQ==",
|
|
2588
2588
|
"funding": [
|
|
2589
2589
|
{
|
|
2590
2590
|
"type": "github",
|