@coralai/sps-cli 0.58.28 → 0.58.30

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.
@@ -56,9 +56,15 @@ Open `sps console` → `/projects/new` → fill form → submit. Form provides:
56
56
  - **Wiki toggle** (v0.51+): scaffolds `wiki/` + writes `WIKI_ENABLED=true` to conf
57
57
  - Merge branch, max workers, ACK timeout, Matrix room
58
58
 
59
- ### Option B — Interactive CLI
59
+ ### Option B — CLI
60
60
  ```bash
61
- sps project init <name> # asks the same questions on tty(含「启用清单验收? (y/N)」一问)
61
+ # 人在终端:交互式向导(含「启用清单验收? (y/N)」一问)
62
+ sps project init <name>
63
+
64
+ # 🔴 agent / 脚本:一律用非交互(裸跑上面那条会等 stdin 阻塞、卡死你的回合)
65
+ sps project init <name> --dir <目录> --yes [--no-git] [--review] [--mode smartArrange --goal "总目标"]
66
+ # --yes 非交互一把建完(--dir 缺省=当前目录)
67
+ # --no-git 关 git(文档/数据项目);--review 开清单验收;--mode/--goal 用 smartArrange
62
68
  ```
63
69
 
64
70
  > **⭐ 建项目时务必确认「要不要开清单验收」**:开了(`SPS_REVIEW=on`)才会在每卡完成后派独立 agent
@@ -309,9 +315,13 @@ sps reset <p> --all # full reset incl. Done
309
315
 
310
316
  ## 6. Pipeline lifecycle commands
311
317
 
318
+ > 🔴 **`sps tick` 是前台无限循环,不 Ctrl+C 永不返回。** 若你是**对话/自动化 agent** 在跑,
319
+ > **绝不要前台裸跑它**(会把你的终端/回合永久卡死)——要么后台 detach
320
+ > `nohup sps tick <项目> >/dev/null 2>&1 &`,要么把命令交给用户去他自己的终端跑。
321
+
312
322
  ```bash
313
323
  # Run continuously (one tick spawns next via cron-like loop)
314
- sps tick <project> # foreground tick(s) — Ctrl+C to stop
324
+ sps tick <project> # foreground tick(s) — Ctrl+C to stop(agent 请后台跑,见上方红字)
315
325
  sps pipeline start <project> # alias for tick
316
326
  sps pipeline stop <project> # graceful stop
317
327
  sps stop <project> # CLI alias for stop