botmux 2.30.0 → 2.31.0-canary.1

package/README.en.md

@@ -276,6 +276,7 @@ Gemini / OpenCode), with no MCP protocol support required.
 - One-click locate back to the Feishu thread / open Web Terminal / multi-select batch close
 - Create a new group with auto owner-transfer + @-mention notification
 - Disband or leave a chat (associated sessions auto-closed)
+- **Workflows console** (read-only): Run List polls every 5s; clicking through opens Run Detail with summary, dangling-work red panel, node/activity table, and event timeline (2s poll, auto-stops once the run reaches a terminal state). Mutations (`run` / `resume` / `cancel`) still go through the `botmux workflow` CLI or IM cards — the v0 UI is observation-only.
 
 <img src="docs/dashboard.png" alt="botmux dashboard" width="800" />
 

package/README.md

@@ -156,6 +156,7 @@ CLI 进入 botmux 会话时自动获得 `~/.botmux/bin` 在 PATH 中，以及一
 - 一键定位回飞书话题 / 跳 Web 终端 / 多选批量关闭会话
 - 拉新群、自动转让群主、@ 提醒
 - 解散群聊、bot 退群（关联会话自动清理）
+- **Workflows 运维面**（read-only）：Run List 5s 轮询，点进 Run Detail 看 summary / dangling 红区 / node-activity 表 / timeline；2s 轮询且 run 到 terminal 后自动停。mutation（run/resume/cancel）仍走 [Workflow CLI 子命令](#workflow-子命令实验性运维) 或 IM 卡片，UI 第一版只读
 
 <img src="docs/dashboard.png" alt="botmux dashboard" width="800" />
 
@@ -355,6 +356,39 @@ botmux autostart enable
 | `botmux autostart status` | 查看自启状态 |
 | `botmux dashboard` | 输出一次 Web Dashboard URL（每次刷 token，旧链接立即失效） |
 
+### Workflow 子命令（实验性运维）
+
+`botmux workflow` 把工作流 run 的状态当一等公民暴露出来——查看哪些 run 在跑、读事件流、从崩溃 / awaiting 恢复或取消。所有命令读写 `BOTMUX_WORKFLOW_RUNS_DIR`（默认 `~/.botmux/workflow-runs`），不需要 daemon 在线。
+
+| 命令 | 说明 |
+|------|------|
+| `botmux workflow run <id> [--param k=v ...]` | 离线驱动 workflow（stub spawn）；humanGate 节点跑到 awaiting-wait 退出 |
+| `botmux workflow resume <runId>` | 从磁盘 runDir 冷恢复一个已有 run；R0 recovery 先收 dangling effect，再走 orchestrator |
+| `botmux workflow cancel <runId> [--reason <text>]` | 写 run-level cancelRequested 并驱动 cancel recovery；terminal run 直接 no-op |
+| `botmux workflow ls [--all] [--status running,failed] [--wide] [--json]` | 列 runsDir 下所有 run；默认仅 non-terminal；`dEf/dAct/dWait` 三列分别是 dangling effects / non-effect activities / waits |
+| `botmux workflow tail <runId> [--from N] [--follow] [--json]` | 打印事件简表；默认 history-only，`--follow` 才轮询 events.ndjson 增量 |
+| `botmux workflow show <runId>` | replay 当前 run 的事件，打 Snapshot 摘要 JSON |
+
+典型运维流程：
+
+```bash
+# 看哪些 run 在跑
+botmux workflow ls
+
+# 进一个 run 看事件
+botmux workflow tail wf-abc-123
+
+# run 卡住或 daemon 重启过 → 冷恢复
+botmux workflow resume wf-abc-123
+
+# 实在跑不动 → 取消
+botmux workflow cancel wf-abc-123 --reason '依赖外部超时'
+```
+
+完整端到端 dogfood（run → ls → tail → resume → cancel）参见 `scripts/dogfood-o1.sh`，跑在临时 runsDir 里，不碰真实环境。
+
+---
+
 ### 开机自启
 
 `botmux autostart enable` 把 daemon 注册到当前用户的 init 系统，重启机器后自动起来：

package/dist/cli/workflow.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `botmux workflow <sub>` CLI subcommand handlers.
+ *
+ * v0 offline-runner: load a workflow definition, drive `runLoop` against
+ * a stub spawn, and print events to stdout.  No daemon / no IM
+ * integration — used for smoke-testing the orchestrator end-to-end.
+ *
+ * The on-daemon path (with lark fan-out, real worker spawn) lives in
+ * the `/workflow run` Skill (Slice E-2).  This module deliberately
+ * keeps the CLI route the simplest possible smoke test.
+ */
+export declare function cmdWorkflow(sub: string, rest: string[]): Promise<void>;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/cli/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/cli/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA8DH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkC5E"}