@coralai/sps-cli 0.59.0 → 0.60.0

package/dist/shared/runtimeSchemas.d.ts

@@ -59,8 +59,8 @@ export declare const WorkerSlotStateSchema: z.ZodObject<{
     lastHeartbeat: z.ZodNullable<z.ZodString>;
     mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         "acp-sdk": "acp-sdk";
-        print: "print";
         acp: "acp";
+        print: "print";
     }>>>;
     agent: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         claude: "claude";
@@ -68,13 +68,13 @@ export declare const WorkerSlotStateSchema: z.ZodObject<{
     pid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     sessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     remoteStatus: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        failed: "failed";
-        running: "running";
         needs_confirmation: "needs_confirmation";
         submitted: "submitted";
+        running: "running";
         waiting_input: "waiting_input";
         stalled_submit: "stalled_submit";
         completed: "completed";
+        failed: "failed";
         cancelled: "cancelled";
         lost: "lost";
     }>>>;
@@ -96,8 +96,8 @@ export declare const StateJsonSchema: z.ZodObject<{
         lastHeartbeat: z.ZodNullable<z.ZodString>;
         mode: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             "acp-sdk": "acp-sdk";
-            print: "print";
             acp: "acp";
+            print: "print";
         }>>>;
         agent: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             claude: "claude";
@@ -105,13 +105,13 @@ export declare const StateJsonSchema: z.ZodObject<{
         pid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         sessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         remoteStatus: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-            failed: "failed";
-            running: "running";
             needs_confirmation: "needs_confirmation";
             submitted: "submitted";
+            running: "running";
             waiting_input: "waiting_input";
             stalled_submit: "stalled_submit";
             completed: "completed";
+            failed: "failed";
             cancelled: "cancelled";
             lost: "lost";
         }>>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coralai/sps-cli",
-  "version": "0.59.0",
+  "version": "0.60.0",
   "description": "SPS CLI — AI-driven development pipeline orchestrator",
   "type": "module",
   "main": "dist/main.js",
@@ -24,7 +24,6 @@
   },
   "files": [
     "dist",
-    "sidecar",
     "project-template",
     "profiles",
     "skills/sps-pipeline",
@@ -33,6 +32,7 @@
     "skills/visual-rubric",
     "skills/checklist-review",
     "skills/skill-creator",
+    "skills/writer",
     "skills/registry.yaml",
     "README.md",
     "README-CN.md"
@@ -58,8 +58,9 @@
   },
   "dependencies": {
     "@agentclientprotocol/sdk": "^0.21.0",
-    "@anthropic-ai/claude-agent-sdk": "^0.2.132",
+    "@anthropic-ai/claude-agent-sdk": "^0.3.196",
     "@colbymchenry/codegraph": "^1.2.0",
+    "@coralai/agent-runtime": "^0.2.0",
     "@coralai/claude-code-agent": "^0.2.6",
     "@hono/node-server": "^2.0.0",
     "@openai/agents": "^0.11.6",

package/skills/registry.yaml

@@ -56,6 +56,7 @@ tags:
   ui:       界面 / 交互
   design:   设计 / 美术 / 视觉
   docs:     文档 / 知识维护
+  writing:  写作 / 文章 / 文字创作
   process:  通用工程流程 / 实践
   # 技术 / 技法面
   2d:       2D 图形

package/skills/sps-chat/SKILL.md

@@ -31,10 +31,20 @@ audience: chat
 **③ 通则**:命令要么**很快返回**,要么**后台跑 + 立刻返回**;拿不准是否常驻/follow → 默认加 `--no-follow` 或后台跑,别赌。
 
 ## 分诊:任何需求 → 先定"怎么产出",再动手
-1. **要产出一个成品**(应用/游戏/图/视频/PPT/文章/文档…)→ SPS 主场:找对应领域 skills → **卡片驱动产出**(见「SPS 项目」)。
-2. **管理已有 SPS 项目 / 卡片 / 流水线** → 见「SPS 项目」。
-3. **一次性小事**(查个信息、改一行、跑个命令)→ 直接用手上工具办,不必上 SPS。
-4. 判断:**多步 / 要成品 / 要复用 → SPS 卡片驱动;一次性 / 简单 → 直接做。**
+先分**你能不能自己在当前目录里做出来**:
+1. **你自己就能产出的交付物**(文章 / 文档 / 分析 / 报告 / 数据整理…,凡靠"读/写文件 + 命令"就能完成的)→ **轻路径**:找领域 skill 按其 SOP 做,**把成品写进当前目录的 `output/`**(见「产出到 output/」)。**不建项目、不上流水线。**
+2. **要一支 worker 队伍并行 / 长流程 / 看板管理的大工程**(软件、游戏等)→ **卡片驱动 pipeline**(见「SPS 项目」)。
+3. **管理已有 SPS 项目 / 卡片 / 流水线** → 见「SPS 项目」。
+4. **一次性小事 / 闲聊**(查信息、讲个笑话、跑个命令)→ 直接办,**不产出文件、不升格**。
+
+判断口诀:**能自己做出成品 → 轻路径写 `output/`;要一支队伍长期做 → pipeline;纯问答 → 直接聊。**
+
+## 产出到 output/(轻路径:你自己就是那个 worker)
+走轻路径产出交付物时:
+1. **先出计划再动手**:复杂交付物先给用户一个简短提纲/计划(几步、每步产什么),默许后逐步做——这就是"拆卡",只是由**你自己**执行,不建卡、不派 worker。
+2. **找领域 skill**:`search_skills(关键词)`(如「写作」「文档」「报告」)→ `load_skill(名字)` 读 SOP 并遵守;没有对应 skill 就凭常识做,但**别假装能做"需要专门工具却没接"的产出**(如出视频)。
+3. **成品落 `output/`**:最终交付物写到当前目录的 **`output/<名字>.<后缀>`**(如 `output/article.md`)。中间草稿/素材放别处或 `output/` 子目录;**最终产物一定在 `output/`**。
+4. **交付说明**:完成后一句话告诉用户产出了什么、在哪(`output/…`)。系统会检测到产物,**把这次对话升格为工作区**留存。
 
 ## SPS 项目
 

package/skills/writer/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: writer
+description: 写作/文档产出 SOP —— 文章、报告、文档、说明、方案、总结等文字交付物。先出提纲(计划)再逐段写,最终成品落 output/<slug>.md。chat 轻路径与 worker 均适用。关键词:写作 文章 文档 报告 方案 总结 blog markdown。
+category: workflow
+tags: [writing, docs]
+---
+
+# Writer —— 文字交付物产出 SOP
+
+产出文章 / 文档 / 报告 / 方案 / 总结等**文字成品**时遵循本 SOP。核心:**先规划、再逐段落盘、成品进 `output/`。**
+
+## 1. 先出提纲(= 拆卡,你自己执行)
+动笔前先给一个**简短提纲/计划**:
+- 交付物是什么(类型、大致篇幅、受众/语气)。
+- 分几个部分,每部分写什么(这就是"卡片",只是由你逐个完成)。
+
+用户已说清就直接按提纲写;关键点不清楚(受众、篇幅、语气、要点)**先问一句**,别自作主张。
+
+## 2. 逐段写,落盘 output/
+- 最终成品写到当前工作目录的 **`output/<slug>.md`**(slug 用简短英文/拼音,如 `output/intro-guide.md`)。
+- 长文可**边写边存**、分节追加;素材/草稿放 `output/` 子目录或临时文件,**最终定稿一定在 `output/` 根下**。
+- 规范 Markdown:标题层级、列表、必要的代码块/表格;不堆废话。
+
+## 3. 交付
+- 完成后**一句话说明**:产出了什么、在哪(`output/…`)、多长/几节。
+- 系统检测到 `output/` 里的产物后,会把这次对话**升格为工作区**留存(用户可回来继续改)。
+
+## 边界
+- 只做"文字"能交付的;要**图/视频/PPT 等需专门工具**的产出,若没接对应技能/工具,**如实说**,别假装能做。
+- 需要多人协作/长期迭代的大文档工程,才考虑走 SPS 卡片驱动 pipeline(见 sps-chat 的「SPS 项目」);一般文章/文档**轻路径自己产出即可**。

package/dist/commands/kokoroCommand.d.ts

@@ -1,2 +0,0 @@
-export declare function executeKokoroCommand(sub: string | undefined): Promise<void>;
-//# sourceMappingURL=kokoroCommand.d.ts.map

package/dist/commands/kokoroCommand.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"kokoroCommand.d.ts","sourceRoot":"","sources":["../../src/commands/kokoroCommand.ts"],"names":[],"mappings":"AAcA,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDjF"}

package/dist/commands/kokoroCommand.js

@@ -1,57 +0,0 @@
-/**
- * @module        commands/kokoroCommand
- * @description   `sps kokoro <setup|start|stop|status>` —— 手动管 Kokoro TTS 边车(本地语音输出引擎)。
- *                console 启动时会自动拉起(已装前提),本命令供首次装配与手动起停/排障。
- * @layer         command
- * @boundedContext worker-lifecycle
- */
-import { ensureKokoroRunning, installKokoro, kokoroStatus, stopKokoro, } from '../core/agents/sidecar/KokoroTtsManager.js';
-export async function executeKokoroCommand(sub) {
-    switch (sub) {
-        case 'setup':
-        case 'install': {
-            // 建 venv → pip 装 kokoro-onnx/misaki[zh] → 下 v1.1-zh 模型(~300MB,首次较慢)。
-            process.stdout.write('装配 Kokoro TTS(首次需下载依赖与模型,请耐心)…\n');
-            const { ok } = await installKokoro((s) => process.stdout.write(s));
-            if (!ok) {
-                process.stderr.write('装配未完成,见上面的错误。\n');
-                process.exitCode = 1;
-                return;
-            }
-            process.stdout.write('装配完成。启动:sps kokoro start(或直接 sps console 会自动拉起)\n');
-            return;
-        }
-        case 'start': {
-            const { installed, started } = await ensureKokoroRunning();
-            if (!installed) {
-                process.stderr.write('未安装。先跑:sps kokoro setup\n');
-                process.exitCode = 1;
-                return;
-            }
-            process.stdout.write(started ? '已启动\n' : '已在运行\n');
-            return;
-        }
-        case 'stop': {
-            const stopped = stopKokoro();
-            process.stdout.write(stopped ? '已停\n' : '未在运行\n');
-            return;
-        }
-        case 'status':
-        case undefined: {
-            const s = await kokoroStatus();
-            process.stdout.write([
-                `installed: ${s.installed ? '是' : '否(sps kokoro setup)'}`,
-                `venv:      ${s.venvReady ? '就绪' : '缺失'}`,
-                `models:    ${s.modelsReady ? '齐全' : '缺失'}`,
-                `running:   ${s.running ? `是 (pid ${s.pid})` : '否'}`,
-                `healthy:   ${s.healthy ? '是' : '否'}`,
-                `baseUrl:   ${s.baseUrl}`,
-            ].join('\n') + '\n');
-            return;
-        }
-        default:
-            process.stderr.write(`未知子命令 '${sub}'。用法:sps kokoro <setup|start|stop|status>\n`);
-            process.exitCode = 1;
-    }
-}
-//# sourceMappingURL=kokoroCommand.js.map

package/dist/commands/kokoroCommand.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"kokoroCommand.js","sourceRoot":"","sources":["../../src/commands/kokoroCommand.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,UAAU,GACX,MAAM,4CAA4C,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAAuB;IAChE,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,OAAO,CAAC;QACb,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,qEAAqE;YACrE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;YACzD,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACnE,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;gBACxC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;YAC1E,OAAO;QACT,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,MAAM,mBAAmB,EAAE,CAAC;YAC3D,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;gBAClD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;YAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QACD,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,CAAC,GAAG,MAAM,YAAY,EAAE,CAAC;YAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB;gBACE,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,qBAAqB,EAAE;gBACzD,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;gBACzC,cAAc,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;gBAC3C,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE;gBACpD,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE;gBACrC,cAAc,CAAC,CAAC,OAAO,EAAE;aAC1B,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CACpB,CAAC;YACF,OAAO;QACT,CAAC;QACD;YACE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,6CAA6C,CAAC,CAAC;YACjF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACzB,CAAC;AACH,CAAC"}