godotmaker-cli 0.2.0 → 0.2.2
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 +22 -0
- package/GETTING_STARTED.md +6 -2
- package/GETTING_STARTED.zh-CN.md +6 -2
- package/README.md +11 -8
- package/README.zh-CN.md +9 -6
- package/dist/run.js +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,27 @@
|
|
|
1
1
|
# godotmaker-cli
|
|
2
2
|
|
|
3
|
+
## 0.2.2
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- [#4](https://github.com/RandallLiuXin/GodotMakerApp/pull/4) [`3fcde94`](https://github.com/RandallLiuXin/GodotMakerApp/commit/3fcde944e99cf0fd90097b5c1b38d4ce3934eb27) Thanks [@RandallLiuXin](https://github.com/RandallLiuXin)! - Add `/goto <state>` so operators can manually set the next pipeline resume target after a stale or incorrect checkpoint.
|
|
8
|
+
|
|
9
|
+
## 0.2.1
|
|
10
|
+
|
|
11
|
+
### Patch Changes
|
|
12
|
+
|
|
13
|
+
- [`a0711f2`](https://github.com/RandallLiuXin/GodotMakerApp/commit/a0711f20b7ec352874d4601c3c122576f0c74b37) Thanks [@RandallLiuXin](https://github.com/RandallLiuXin)! - ClaudeRunner now defaults `skipPermissions` to true, matching CodexRunner. Interactive stages (scaffold, gdd, accept) no longer prompt for per-tool or per-skill permission mid-run. Callers that want the `--allowedTools` gate pass `skipPermissions: false` explicitly.
|
|
14
|
+
|
|
15
|
+
- [`3afcc28`](https://github.com/RandallLiuXin/GodotMakerApp/commit/3afcc28b16e4e5c6b1866dc2f35318538fdad8b4) Thanks [@RandallLiuXin](https://github.com/RandallLiuXin)! - Fix failed-stage retry resume targets so `/start` reruns the stage that failed instead of the previously completed stage.
|
|
16
|
+
|
|
17
|
+
- [`5b7d0fc`](https://github.com/RandallLiuXin/GodotMakerApp/commit/5b7d0fcf179a7b497d8f5eb34a7d7076cd74b729) Thanks [@RandallLiuXin](https://github.com/RandallLiuXin)! - Fix idle-timeout cleanup so silent agent sessions attempt process-tree termination and still fail the stage if the killed process never reports exit.
|
|
18
|
+
|
|
19
|
+
- [`01879b3`](https://github.com/RandallLiuXin/GodotMakerApp/commit/01879b3b86f82819c3382338b0f7e0c237448975) Thanks [@RandallLiuXin](https://github.com/RandallLiuXin)! - Recover in-flight usage checkpoints on the next launch so project lifetime totals keep completed state work when a runner or CLI process exits before the final usage write.
|
|
20
|
+
|
|
21
|
+
- [`b04cc00`](https://github.com/RandallLiuXin/GodotMakerApp/commit/b04cc00843551803b9845ac7e980b6d23b31f313) Thanks [@RandallLiuXin](https://github.com/RandallLiuXin)! - Remove USD cost tracking from usage data.
|
|
22
|
+
|
|
23
|
+
- [`463197a`](https://github.com/RandallLiuXin/GodotMakerApp/commit/463197af55ee050623e3f8553a8c1d7e71a3537a) Thanks [@RandallLiuXin](https://github.com/RandallLiuXin)! - Settle agent stages after structured Codex or Claude success events when the runner process fails to close.
|
|
24
|
+
|
|
3
25
|
## 0.2.0
|
|
4
26
|
|
|
5
27
|
### Minor Changes
|
package/GETTING_STARTED.md
CHANGED
|
@@ -30,7 +30,7 @@ The CLI auto-publishes the GodotMaker framework (`/gm-scaffold`,
|
|
|
30
30
|
`/gm-gdd`, `/gm-asset`, `/gm-build`, `/gm-verify`, `/gm-evaluate`,
|
|
31
31
|
`/gm-fixgap`, `/gm-accept`, `/gm-finalize`) into each project during
|
|
32
32
|
preflight, pinned to the version in `cliConfig.pinnedGodotmakerVersion`
|
|
33
|
-
(currently `v0.5
|
|
33
|
+
(currently `v0.6.5`).
|
|
34
34
|
|
|
35
35
|
### Install or run the CLI
|
|
36
36
|
|
|
@@ -381,15 +381,19 @@ godotmaker-cli --max-iterations 5
|
|
|
381
381
|
/start # begin (or resume after a pause) the pipeline
|
|
382
382
|
/pause # pause the running pipeline (cli stays mounted; /start to resume)
|
|
383
383
|
/refresh # reset iteration / build budget (idle / paused / finished / failed; /pause first if running)
|
|
384
|
+
/goto asset # set the next /start resume target manually (idle / paused / failed)
|
|
384
385
|
/help # commands list
|
|
385
386
|
/peek # live tail of the active agent session (non-interactive states only)
|
|
386
|
-
/usage # token /
|
|
387
|
+
/usage # token / time totals (this run + project lifetime)
|
|
387
388
|
/quit # exit in any state; during a run also aborts the selected agent + writes a resume checkpoint
|
|
388
389
|
q # exit, but only when not running (input bar empty); same checkpoint path as /quit
|
|
389
390
|
Ctrl-C # exit in any state; during a run also aborts the selected agent + writes a resume checkpoint
|
|
390
391
|
Esc # clear input buffer
|
|
391
392
|
```
|
|
392
393
|
|
|
394
|
+
`/goto` accepts `scaffold`, `gdd`, `asset`, `build`, `verify`, `evaluate`,
|
|
395
|
+
`fixgap`, `accept`, or `finalize`.
|
|
396
|
+
|
|
393
397
|
---
|
|
394
398
|
|
|
395
399
|
## Where to go next
|
package/GETTING_STARTED.zh-CN.md
CHANGED
|
@@ -25,7 +25,7 @@
|
|
|
25
25
|
CLI 会在 preflight 时把 GodotMaker framework(`/gm-scaffold`、
|
|
26
26
|
`/gm-gdd`、`/gm-asset`、`/gm-build`、`/gm-verify`、`/gm-evaluate`、
|
|
27
27
|
`/gm-fixgap`、`/gm-accept`、`/gm-finalize`)自动 publish 到项目里,
|
|
28
|
-
版本由 `cliConfig.pinnedGodotmakerVersion` 决定(当前 `v0.5
|
|
28
|
+
版本由 `cliConfig.pinnedGodotmakerVersion` 决定(当前 `v0.6.5`)。
|
|
29
29
|
|
|
30
30
|
### 安装或运行 CLI
|
|
31
31
|
|
|
@@ -327,15 +327,19 @@ godotmaker-cli --max-iterations 5
|
|
|
327
327
|
/start # 启动(或 pause 后恢复)pipeline
|
|
328
328
|
/pause # 暂停正在跑的 pipeline(cli 保持挂载;/start 即可恢复)
|
|
329
329
|
/refresh # 重置 iteration / build 预算(idle / paused / finished / failed;running 中先 /pause)
|
|
330
|
+
/goto asset # 手动设置下一次 /start 的 resume 目标(idle / paused / failed)
|
|
330
331
|
/help # 命令列表
|
|
331
332
|
/peek # 实时尾巴查看当前 agent session(仅非交互态有效)
|
|
332
|
-
/usage # token /
|
|
333
|
+
/usage # token / 时长汇总(当前运行 + 项目累计)
|
|
333
334
|
/quit # 退出(任意状态);运行中也会顺手 abort 选中 agent + 写 resume 检查点
|
|
334
335
|
q # 退出(仅在非 running 状态生效,且输入栏需为空);走的是 /quit 同一条检查点路径
|
|
335
336
|
Ctrl-C # 退出(任意状态);运行中按下会同时 abort 选中 agent + 写 resume 检查点
|
|
336
337
|
Esc # 清空输入栏
|
|
337
338
|
```
|
|
338
339
|
|
|
340
|
+
`/goto` 接受 `scaffold`、`gdd`、`asset`、`build`、`verify`、`evaluate`、
|
|
341
|
+
`fixgap`、`accept`、`finalize`。
|
|
342
|
+
|
|
339
343
|
---
|
|
340
344
|
|
|
341
345
|
## 接下来
|
package/README.md
CHANGED
|
@@ -19,7 +19,7 @@ Pipeline driver for [GodotMaker](https://github.com/RandallLiuXin/GodotMaker)
|
|
|
19
19
|
| [Claude Code CLI](https://docs.claude.com/en/docs/claude-code) or Codex CLI | latest | The selected agent binary must be on your PATH |
|
|
20
20
|
| [Godot](https://godotengine.org/) | 4.x | Runs the generated project |
|
|
21
21
|
|
|
22
|
-
The CLI auto-publishes the GodotMaker framework into each project during preflight; the framework version is pinned by `cliConfig.pinnedGodotmakerVersion` (currently `v0.5
|
|
22
|
+
The CLI auto-publishes the GodotMaker framework into each project during preflight; the framework version is pinned by `cliConfig.pinnedGodotmakerVersion` (currently `v0.6.5`).
|
|
23
23
|
|
|
24
24
|
---
|
|
25
25
|
|
|
@@ -107,10 +107,14 @@ the following and press `Enter`:
|
|
|
107
107
|
| `/start` | Begin (or resume, after a pause) the pipeline |
|
|
108
108
|
| `/pause` | Pause the running pipeline; the next `/start` resumes |
|
|
109
109
|
| `/refresh` | Reset iteration / build budget for the current run; allowed in idle / paused / finished / failed (during a run, `/pause` first) |
|
|
110
|
+
| `/goto <state>` | Set the next `/start` resume target manually; allowed in idle / paused / failed |
|
|
110
111
|
| `/peek` | Live tail (1 Hz) of the active non-interactive agent stream log |
|
|
111
|
-
| `/usage` | Token /
|
|
112
|
+
| `/usage` | Token / time totals for this run + project lifetime |
|
|
112
113
|
| `/quit` | Exit. During a run, also aborts the selected agent and writes a resume checkpoint (same path as Ctrl-C); next `godotmaker-cli` launch can `/start` to continue. |
|
|
113
114
|
|
|
115
|
+
`/goto` is a manual recovery override. Valid states are `scaffold`, `gdd`,
|
|
116
|
+
`asset`, `build`, `verify`, `evaluate`, `fixgap`, `accept`, and `finalize`.
|
|
117
|
+
|
|
114
118
|
The current iteration / build try / last evaluation verdict are
|
|
115
119
|
shown in the Header at the top of the TUI; there is no separate
|
|
116
120
|
overlay for them. The eval cell shows `✓ approved` (green) on
|
|
@@ -138,11 +142,10 @@ you invoke it then. The overlay refreshes once per second; press any
|
|
|
138
142
|
key to dismiss.
|
|
139
143
|
|
|
140
144
|
`/usage` shows three sections: **this run** (live token / output /
|
|
141
|
-
duration
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
shown when the selected agent reports it; otherwise it stays `--`.
|
|
145
|
+
duration broken down per state), **project lifetime** (cumulative
|
|
146
|
+
since the first run), and **recent runs** (the last 10 completed runs
|
|
147
|
+
as one row each). Tokens come from the selected agent's stream or local
|
|
148
|
+
session records.
|
|
146
149
|
Persisted to `.godotmaker/usage.json` next to `pipeline_state.json`
|
|
147
150
|
— copy that file along with the project to keep history when moving
|
|
148
151
|
the project elsewhere. Interactive states (scaffold / gdd / accept)
|
|
@@ -184,7 +187,7 @@ Everything lives under `.godotmaker/` inside your project:
|
|
|
184
187
|
| `stage.jsonl` | upstream skills | One line per `/gm-*` completion; freshness-checked by Core |
|
|
185
188
|
| `evaluation.json` | `/gm-evaluate` | Latest binary verdict + categorized issues; routes evaluate → accept / fixgap |
|
|
186
189
|
| `final_report.json` | `/gm-finalize` | Summary at the end of a successful run |
|
|
187
|
-
| `usage.json` | Core | Token /
|
|
190
|
+
| `usage.json` | Core | Token / time history surfaced by `/usage` (lifetime totals + last 10 runs) — see R-314 |
|
|
188
191
|
| `config.yaml` | (optional, you) | Per-project flag defaults — see `loadConfig` in core |
|
|
189
192
|
|
|
190
193
|
The Godot project itself (`project.godot`, `GDD.md`, `PLAN.md`, scenes, scripts, …) lives at the project root and is owned by the upstream skills. Core never writes to those.
|
package/README.zh-CN.md
CHANGED
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
| [Claude Code CLI](https://docs.claude.com/en/docs/claude-code) 或 Codex CLI | latest | 选中的 agent 二进制必须在 PATH 上 |
|
|
19
19
|
| [Godot](https://godotengine.org/) | 4.x | 运行生成出来的项目 |
|
|
20
20
|
|
|
21
|
-
CLI 会在 preflight 时把 GodotMaker framework 自动 publish 到项目里;framework 版本由 `cliConfig.pinnedGodotmakerVersion` 决定(当前 `v0.5
|
|
21
|
+
CLI 会在 preflight 时把 GodotMaker framework 自动 publish 到项目里;framework 版本由 `cliConfig.pinnedGodotmakerVersion` 决定(当前 `v0.6.5`)。
|
|
22
22
|
|
|
23
23
|
---
|
|
24
24
|
|
|
@@ -103,10 +103,14 @@ TUI 底部有一个常驻输入栏。输入下面任一命令然后回车:
|
|
|
103
103
|
| `/start` | 启动(或 pause 后恢复)pipeline |
|
|
104
104
|
| `/pause` | 暂停正在运行的 pipeline;下次 `/start` 从中断处恢复 |
|
|
105
105
|
| `/refresh` | 重置当前 run 的 iteration / build 预算;允许在 idle / paused / finished / failed 状态使用(running 中需先 `/pause`) |
|
|
106
|
+
| `/goto <state>` | 手动设置下一次 `/start` 的 resume 目标;允许在 idle / paused / failed 状态使用 |
|
|
106
107
|
| `/peek` | 实时尾巴(1 Hz)查看当前非交互 agent stream 日志 |
|
|
107
|
-
| `/usage` | 当前运行 + 项目累计 token /
|
|
108
|
+
| `/usage` | 当前运行 + 项目累计 token / 时长 |
|
|
108
109
|
| `/quit` | 退出。运行中按下也会顺手 abort 选中 agent 并写 resume 检查点(跟 Ctrl-C 同一条路),下次 `godotmaker-cli` 启动 `/start` 即可从中断处恢复。 |
|
|
109
110
|
|
|
111
|
+
`/goto` 是手动恢复 override。合法 state 是 `scaffold`、`gdd`、`asset`、
|
|
112
|
+
`build`、`verify`、`evaluate`、`fixgap`、`accept`、`finalize`。
|
|
113
|
+
|
|
110
114
|
当前 iteration / build try / 最近一次评估的 verdict 都直接显示在 TUI
|
|
111
115
|
顶部的 Header 里,没有单独的 overlay。eval 单元格在 approve 时显示
|
|
112
116
|
`✓ approved`(绿色),reject 时显示 `✗ Nc+Mm`(黄色,N/M 分别是
|
|
@@ -128,10 +132,9 @@ finalize)下有意义 —— 这些状态里 选中 agent 以非交互模式
|
|
|
128
132
|
to tail" 提示。Overlay 每秒刷新一次;任意键关闭。
|
|
129
133
|
|
|
130
134
|
`/usage` 分三块显示:**当前运行**(按 state 拆分的实时 token / 输出 /
|
|
131
|
-
|
|
135
|
+
时长)、**项目累计**(自首次运行以来的总和)和 **最近运行**
|
|
132
136
|
(最近 10 次完成的运行,每次一行)。Token 来自选中 agent 的 stream
|
|
133
|
-
或本地 session
|
|
134
|
-
`--`。数据持久化到 `.godotmaker/usage.json`(紧挨着
|
|
137
|
+
或本地 session 记录。数据持久化到 `.godotmaker/usage.json`(紧挨着
|
|
135
138
|
`pipeline_state.json`)—— 把这个文件跟项目一起搬迁就能保留历史。
|
|
136
139
|
交互态(scaffold / gdd / accept)会尽力从本地 session 记录恢复 token,
|
|
137
140
|
并始终贡献时长。Header 始终展示当前运行的简写总数,`/usage` 用来看细节。
|
|
@@ -168,7 +171,7 @@ flag。timer 在每次收到 stdout/stderr 时刷新,只有真静默才会触
|
|
|
168
171
|
| `stage.jsonl` | 上游 skill | 每个 `/gm-*` 完成一行;Core 做 freshness 检查 |
|
|
169
172
|
| `evaluation.json` | `/gm-evaluate` | 最近一次的二元 verdict + 分类 issue;evaluate → accept / fixgap 路由依据 |
|
|
170
173
|
| `final_report.json` | `/gm-finalize` | 成功跑完的总结 |
|
|
171
|
-
| `usage.json` | Core | `/usage` 用的 token /
|
|
174
|
+
| `usage.json` | Core | `/usage` 用的 token / 时长历史(lifetime 累计 + 最近 10 次运行)—— 见 R-314 |
|
|
172
175
|
| `config.yaml` | (可选,由你写) | 项目级 flag 默认值 —— 见 core 里的 `loadConfig` |
|
|
173
176
|
|
|
174
177
|
Godot 项目本身(`project.godot`、`GDD.md`、`PLAN.md`、scenes、scripts、…)放在项目根目录,由上游 skill 拥有,Core 永不写它们。
|