botmux 2.93.0 → 2.94.0

package/dist/skills/definitions.js

@@ -7,6 +7,7 @@
  *   - not depend on MCP tools (which may not be wired on every CLI)
  *   - keep frontmatter minimal — just `name` and `description` for discovery
  */
+import { ASK_HUMAN_ERROR_CODE, GOAL_ASK_FILE, GOAL_ENV } from '../workflows/v3/contract.js';
 const SCHEDULE_SKILL = `---
 name: botmux-schedule
 description: 在当前飞书/Lark 话题里创建、管理定时提醒（用 botmux schedule 命令，支持增删查改暂停恢复）。触发场景：用户说"每天X点"、"每周X"（任意星期，不限周一）、"每月X号"、"N分钟后/N小时后"、"明天X点"、"提醒我"、"定时任务"、"周期任务"、"recurring"、"reminder"、"crontab" 时；或显式提到 botmux schedule。到点后 daemon 会在原话题自动续一条消息并触发新 CLI 会话。注意区分：本 skill 是飞书话题内提醒；要在云端跑 remote agent 用 superpowers:schedule；要在当前会话循环跑 prompt 用 loop。
@@ -531,7 +532,7 @@ description: 根据用户自然语言描述生成 botmux workflow JSON 定义文
 
 # botmux-workflow-create — Workflow 编排助手
 
-把用户口头描述的几步任务翻译成可执行的 workflow JSON。本 skill 只负责设计、生成、校验，不负责启动 run；启动用 \`botmux workflow run <id>\` 或 IM \`/workflow run <id>\`。
+把用户口头描述的几步任务翻译成可执行的 workflow JSON。本 skill 只负责设计、生成、校验，不负责启动 run；启动用 \`botmux workflow run <id>\` 或 IM \`/template run <id>\`。
 
 ## 硬规则
 
@@ -600,10 +601,10 @@ validate 能抓 JSON/schema/graph 错误；但它**不会**检查 bot 是否真
 \`\`\`bash
 botmux workflow run <workflowId> --param key=value
 # 或在飞书话题里:
-/workflow run <workflowId> key=value
+/template run <workflowId> key=value
 \`\`\`
 
-如果 workflow 定义了 object / array 类型入参，CLI 用 \`--param-json key=<json>\`；IM \`/workflow run\` 暂不支持 object / array 入参。
+如果 workflow 定义了 object / array 类型入参，CLI 用 \`--param-json key=<json>\`；IM \`/template run\` 暂不支持 object / array 入参。
 
 ## Schema 速查
 
@@ -647,7 +648,7 @@ botmux workflow run batch-send --param-json tags='["urgent","cn"]'
 botmux workflow run batch-send --param-json config='{"mode":"safe","limit":3}'
 
 # IM: 只支持 key=value 标量；object / array 暂不支持
-/workflow run weather-city city=上海 days=3 dryRun=false
+/template run weather-city city=上海 days=3 dryRun=false
 \`\`\`
 
 在节点里既可以用 \`{ "$ref": "params.<path>" }\` 整字段替换，也可以在字符串里 \`"\${params.<path>}"\` 内嵌（仅限值是标量时）。嵌套对象用点号路径：\`params.user.email\`。
@@ -988,6 +989,95 @@ stdout 为一行 JSON。注意：\`--json\` 覆盖所有结果类型；超时 /
 - 不支持 comment / multi-select / free-form text（v0.1.7 范围外）
 - 默认超时 300 秒，可用 \`--timeout <seconds>\` 调整
 `;
+const GOAL_ASK_SKILL = `---
+name: botmux-goal-ask
+description: v3 goal-mode 节点在真正需要人类判断时使用的文件式 ask 协议。触发场景：你运行在 botmux v3 goal-mode，必须让人做选择或补充自由文本，且无法自行研究或推断。不要调用原生 AskUserQuestion，也不要调用 botmux ask；写 ask.json + ASK_HUMAN failure manifest 后停止。
+---
+
+# botmux-goal-ask — v3 goal-mode 人类判断
+
+你运行在 botmux v3 goal-mode 时，不能打开原生交互问答，也不能调用 \`botmux ask\`。如果且仅如果你遇到**必须由人做判断或补充信息**的问题，使用本文件协议暂停节点。
+
+## 什么时候用
+
+- 需要产品 / 业务 / 风险决策，不能通过读取文件、运行命令、搜索资料自行判断
+- 选项已经清楚，可以给出 2-6 个具体选择
+- 需要人补充一段规则、细节、边界说明，不能改写成有限选项
+- 没有人回答前继续执行会改变方向或造成风险
+
+## 什么时候不要用
+
+- 登录、鉴权、权限、外部确认弹窗：写普通 retryable failure manifest（如 \`AUTH_REQUIRED\`），不要 ask
+- 你可以自行推断、测试或查证的问题：直接处理，不要打断人
+- workflow 节点审批：外层 humanGate 已经处理，不要套 ask
+- 可以通过有限选项表达的问题：优先用 options，不要滥用自由文本
+
+## 协议
+
+1. 写 ask 文件到当前 attempt 目录。
+
+选择题：
+
+\`\`\`json
+{
+  "question": "一个清晰的问题",
+  "options": ["选项 A", "选项 B"]
+}
+\`\`\`
+
+填空题：
+
+\`\`\`json
+{
+  "question": "请补充计费规则的边界说明",
+  "freeText": true
+}
+\`\`\`
+
+路径必须是：
+
+\`\`\`bash
+$${GOAL_ENV.ATTEMPT_DIR}/${GOAL_ASK_FILE}
+\`\`\`
+
+2. 立刻写 failure manifest 到：
+
+\`\`\`bash
+$${GOAL_ENV.MANIFEST_PATH}
+\`\`\`
+
+manifest 的要求：
+
+\`\`\`json
+{
+  "schemaVersion": 1,
+  "status": "fail",
+  "summary": "同 ask.question 的一句话摘要",
+  "files": [],
+  "error": {
+    "code": "${ASK_HUMAN_ERROR_CODE}",
+    "message": "同 ask.question",
+    "retryable": true
+  }
+}
+\`\`\`
+
+3. 写完 manifest 后停止，不要继续执行。
+
+人类选择后，runtime 会重跑该节点，并把答案注入到：
+
+\`\`\`bash
+$${GOAL_ENV.INPUTS_PATH}
+\`\`\`
+
+输入的 \`inputs[]\` 里会有一个条目：
+
+\`\`\`json
+{ "from": "human", "name": "answer", "path": "/absolute/path/to/answer.json", "kind": "json" }
+\`\`\`
+
+读取它的 \`path\`：选择题看 \`selected\`，填空题看 \`text\`，然后继续完成原目标。
+`;
 const ORCHESTRATE_SKILL = `---
 name: botmux-orchestrate
 description: 作为「主 bot/编排者」把一个大项目拆成多个子项目，在普通群里自动开多话题、把不同 bot（常 coder+reviewer 一组）派进各话题并行干活，用飞书任务清单当共享进度板，收齐结果再汇总。触发：用户提到「多话题协作模式」，或要「把大项目拆给多个机器人并行做」「协调多个 bot」「多话题并行推进」「你当总控/编排」「一个写一个 review 多组并行」，或显式提到 botmux orchestrate / botmux dispatch 派活。
@@ -1060,6 +1150,118 @@ botmux dispatch --title "<子项目标题>" --bot "<coder_open_id>:名字:coder"
 - 一条话题别塞太多 bot；coder+reviewer 两人一组最顺。
 - 失败别硬重试同一招 ≥3 次；上报用户。
 `;
+const WORKFLOW_V3_SKILL = `---
+name: botmux-workflow
+description: 把一个「模糊的、一次性的、需要拆成多步的目标」交给系统：先 grill 把需求问清楚 → 自动编排成 DAG 流程 → 跑完。触发场景：用户给一个复合/探索性任务且没指定具体步骤，如"帮我调研X出报告"、"把这事拆成几步自动跑完"、"做个 workflow 处理…"、"帮我把 A/B/C 串起来自动做"；用户显式发 \`/workflow new <目标>\` 或裸 \`/workflow <目标>\` 也会路由到本 skill。区别：跑已存好的固定流程模板用 \`/template run <id>\`（不是本 skill）；设计可复用模板用 botmux-workflow-create；本 skill 是一次性即兴 workflow。简单单步请求/普通问答/改代码不要触发；进入前先跟用户确认一句。
+---
+
+# botmux-workflow — v3 即兴 workflow（grill → 编排 → 跑）
+
+把用户一句模糊的复合目标，通过「拷问澄清 → 自动编排 DAG → 人确认 → 自动执行」一条龙做完。整个过程在当前飞书话题里**一问一答**进行（用 botmux send 跟用户对话）。
+
+用户可以两种方式进入本流程：① 直接用大白话描述模糊复合目标（模型判断触发本 skill）；② 显式发 \`/workflow new <目标>\` 或裸 \`/workflow <目标>\`（daemon 已把它转成触发本 skill 的 prompt，目标在消息里）。
+
+## 何时用 / 不用
+- ✅ 用户有一个**一次性、需要拆成多步**的目标，但没给出具体步骤（"调研三家竞品出对比报告"、"把日志拉下来分析再生成图表"）。
+- ❌ 跑**已存好的固定模板** → 让用户用 \`/template run <id>\`。
+- ❌ **设计可复用模板** → botmux-workflow-create。
+- ❌ 单步请求 / 普通问答 / 改代码 → 别触发，正常回答。
+
+## 0. 先确认（防误触发）
+真正进入 grill 前先发一句确认：
+
+> 我理解你想让我做一整套 workflow：先问你几个问题把需求弄清楚，再自动编排成流程跑完。对吗？
+
+用户确认了再往下。（用户已经很明确要做 workflow——比如通过 \`/workflow new\` 显式发起——时可省略此步，直接开始 grill。）
+
+## 1. 建 run
+\`\`\`bash
+botmux workflow new "<把用户目标浓缩成一句话>"
+\`\`\`
+记下返回的 \`runId\`（和 \`specPath\`）——后面**每个**命令都要带这个 runId。
+
+## 2. Grill：一次只问一个问题
+遵循 grill-me 方法：
+- **一次一个问题**，每个都给出你的**推荐默认答案**（不是开放式"你想怎样"）。
+- 沿决策树走，先父决策再子决策。
+- 能从代码/文件查到的**别问，直接查**。
+- 目标：能为**每个**预想节点凑齐五件套 \`goal / input_needs / expected_outputs / acceptance / risk_gate\`，否则继续问。
+- **逃生阀**：用户随时可说"够了 / 用默认 / 别问了"——立即收尾，用推荐默认填满缺口，把没定的写进该节点 \`unknowns\`。
+- 别把用户问烦：五件套是上限不是下限，能合并的问题合并。
+
+## 3. 写 spec.md
+往第 1 步返回的 \`specPath\` 写文件 = 人读叙事 + **唯一一个** fenced json 块（机器读的 canonical Spec）。
+
+人读部分：\`## 需求\` / \`## 决策树\`（决策点+结论+拒绝的备选）/ \`## 验收标准\` / \`## 非目标\`。
+
+机器读部分（**只放一个** json 代码块，schema 如下）：
+\`\`\`json
+{
+  "schemaVersion": 1,
+  "runId": "<第1步的 runId>",
+  "title": "<一句话标题>",
+  "requirement": "<收敛后的清晰需求>",
+  "acceptance": "<整体验收标准>",
+  "nonGoals": ["<明确不做的>"],
+  "nodes": [
+    {
+      "sketchId": "research",
+      "goal": "调研 X/Y/Z 的定价与功能，写成 facts.md",
+      "input_needs": [],
+      "expected_outputs": ["facts.md"],
+      "acceptance": "每家含定价档+功能矩阵",
+      "risk_gate": false,
+      "unknowns": []
+    },
+    {
+      "sketchId": "report",
+      "goal": "基于调研产物写竞品分析报告 report.md",
+      "input_needs": ["research 阶段产出的竞品事实"],
+      "expected_outputs": ["report.md"],
+      "acceptance": "含结论与建议",
+      "risk_gate": true,
+      "unknowns": []
+    }
+  ]
+}
+\`\`\`
+**字段铁律**：
+- \`input_needs\` 是**自由文本**描述"这步需要什么信息/产物"，**绝不要写成上游 sketchId 列表**——画依赖边是 architect 的活，不是你的。
+- \`risk_gate: true\` = 这步执行期要人工审批（如对外发送）。
+- \`unknowns\` 放没跟用户定死、用了默认的点。
+
+## 4. 校验 spec
+\`\`\`bash
+botmux workflow spec-finalize <runId>
+\`\`\`
+成功 → 下一步。失败（命令打印 problems）→ 按 problems 修 spec.md 的 json 块再跑。**校验不过不能往下走。**
+
+## 5. Gate-1：确认需求
+给用户简明摘要（做哪几步、各自产出、验收、不做什么），问：
+
+> 这是我理解的需求和拆解，对吗？确认我就编排成可执行流程。
+
+用户确认 → \`botmux workflow approve-spec <runId>\`；要改 → 直接改 spec.md 再 \`botmux workflow spec-finalize <runId>\` 重新校验（spec_ready 状态可原地重定稿，不用退回）。
+
+## 6. 编排 DAG
+\`\`\`bash
+botmux workflow architect <runId>
+\`\`\`
+系统自动把 spec 编译成 dag.json 并**由 host 校验**。成功 → 命令打印 \`dagPath\`/\`notesPath\`，进下一步。失败（退回 spec_approved + 打印 problems）→ 多半是 spec 还有问题：\`botmux workflow revise-spec <runId>\` 退回 grilling，按 problems 改 spec.md，再 spec-finalize → approve-spec → architect。（若判断只是 architect 偶发失败、spec 没问题，可直接重跑 architect。）
+
+## 7. Gate-2：确认流程
+读 architect 产出的 dag.json + architect-notes.md（用第 6 步打印的路径），给用户讲清楚流程：有哪些节点、依赖顺序、哪些节点执行期会停下等人批。问：
+
+> 编排好的流程是这样，对吗？确认就开跑。
+
+用户确认 → \`botmux workflow approve-dag <runId>\`，然后 \`botmux workflow start <runId>\` 交 daemon 驱动开跑（**别用 \`botmux v3 run\`**——那是 dev 终端路径，没有飞书审批卡）。daemon 路径下，节点的 \`risk_gate\`（humanGate）执行期会在本话题**弹审批卡**，用户点「通过/拒绝」才继续；daemon 重启也能恢复待审批的卡。要改：需求要改 → \`botmux workflow revise-spec <runId>\`（退回 grilling，原 DAG 作废）重走 grill→spec→architect；需求没变、只是流程不满意 → \`botmux workflow revise-dag <runId>\`（退回 spec_approved）重跑 architect 重编。
+
+## 关键纪律
+- 全程飞书一问一答，用 botmux send 对话。
+- \`runId\` 是贯穿全程的钥匙，每个命令都带对。
+- 三道确认别省：进入前确认 + Gate-1 需求 + Gate-2 流程。
+- 任何 \`botmux workflow\` 命令报错，把人话版原因告诉用户，别闷头重试。
+`;
 export const WHITEBOARD_SKILL = `---
 name: botmux-whiteboard
 description: 使用 botmux 本地项目白板读写跨 agent 的项目摘要、关键决策、已验证命令、阻塞和交接信息。触发场景：用户说白板、上下文、项目记忆、让其他 agent 看本地总结、长任务断点、多 agent 协作、handoff、需要沉淀不适合发飞书的大段上下文时。
@@ -1193,6 +1395,8 @@ export const BUILTIN_SKILLS = [
     { name: 'botmux-bots', content: BOTS_SKILL },
     { name: 'botmux-handoff', content: HANDOFF_SKILL },
     { name: 'botmux-workflow-create', content: WORKFLOW_CREATE_SKILL },
+    { name: 'botmux-workflow', content: WORKFLOW_V3_SKILL },
+    { name: 'botmux-goal-ask', content: GOAL_ASK_SKILL },
     { name: 'botmux-orchestrate', content: ORCHESTRATE_SKILL },
 ];
 /** Skills that earlier botmux versions installed but no longer ship. The

package/dist/skills/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/skills/definitions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/skills/definitions.ts"],"names":[],"mappings":"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"}

package/dist/worker.js

@@ -253,7 +253,16 @@ async function sendRawCommandLine(be, content) {
         be.sendSpecialKeys('Enter');
     }
     else {
-        be.write(content + '\r');
+        // PtyBackend has no sendText/sendSpecialKeys, so write the keystrokes
+        // directly — but still beat between the text and the Enter. Writing
+        // `content + '\r'` in one chunk submits before the CLI's slash-command
+        // parser has registered the `/cmd` match, so the command is left
+        // unsent in the input box (observed with `/goal <text>` on a pty
+        // workflow worker: typed but never executed). Mirror the tmux path's
+        // 200ms beat.
+        be.write(content);
+        await new Promise(r => setTimeout(r, 200));
+        be.write('\r');
     }
 }
 /** Resolve once the PTY has been quiet for `quietMs`, or after `capMs` total.
@@ -4990,8 +4999,14 @@ function startWebServer(host, preferredPort) {
                             backend?.resize(msg.cols, msg.rows);
                         }
                         else if (msg.type === 'input' && typeof msg.data === 'string') {
-                            if (!authedClients.has(ws))
-                                return; // read-only
+                            if (!authedClients.has(ws)) {
+                                // Read-only: allow ONLY wheel scroll sequences (SGR buttons 64-67).
+                                // Scrolling the CLI's own view is non-destructive and lets read-only
+                                // viewers page back through an alt-screen TUI's history (Claude etc.,
+                                // which has no local scrollback). Everything else is dropped.
+                                if (!/^(\x1b\[<6[4-7];\d+;\d+M)+$/.test(msg.data))
+                                    return;
+                            }
                             backend?.write(msg.data);
                         }
                     }
@@ -5203,12 +5218,45 @@ window.addEventListener('resize',onViewportResize);
   ws.onerror=function(){ws.close()};
 })();
 
-// ── Read-only scroll handling ──
-if(!hasToken&&!${isTmuxMode && !isPipeMode}){
-  // Non-tmux read-only: CLI mouse mode blocks local scroll, override with scrollLines
+// ── Wheel / touch scroll handling ──
+// Alt-screen + mouse-mode CLIs (e.g. Claude Code) keep NO scrollback in xterm OR
+// tmux — their whole transcript is redrawn by the app inside the fixed alt-screen
+// grid, so term.scrollLines() reveals nothing. In the alternate buffer we forward
+// scrolling as SGR mouse-wheel events so the CLI scrolls its own transcript and
+// repaints (works in read-only too: the server only lets wheel sequences through).
+// Normal-buffer CLIs keep xterm's native scrollback scroll. Capture-phase +
+// stopPropagation pre-empts xterm's own handler. Skipped for pure tmux/zellij
+// ATTACH (gate), where the attach client owns scrolling via copy-mode.
+//
+// Accumulate intended scroll DISTANCE (px) and emit one wheel tick per STEP px —
+// decoupled from how many wheel/touch events the browser fires per gesture
+// (high-res trackpads fire dozens), so a small gesture stays a small scroll and
+// doesn't compound into a whole screen. px<0 = scroll up (toward history). The
+// per-call cap stops a single huge delta (page tick / fling) from over-firing.
+var _scrollAccum=0;var _SCROLL_STEP=33;
+function _fwdScroll(px){
+  if(!ws_||ws_.readyState!==1)return;
+  _scrollAccum+=px;var data='',n=0;
+  while(Math.abs(_scrollAccum)>=_SCROLL_STEP&&n<6){
+    var up=_scrollAccum<0; // px<0 → wheel-up (history)
+    data+='\\x1b[<'+(up?64:65)+';1;1M';
+    _scrollAccum+=up?_SCROLL_STEP:-_SCROLL_STEP;n++;
+  }
+  if(data)ws_.send(JSON.stringify({type:'input',data:data}));
+}
+if(!${isTmuxMode && !isPipeMode}){
   document.getElementById('terminal').addEventListener('wheel',function(e){
-    e.preventDefault();term.scrollLines(e.deltaY>0?3:-3);
-  },{passive:false});
+    if(term.buffer.active.type!=='alternate'){
+      // Normal buffer: xterm scrolls its own scrollback natively. In read-only a
+      // mouse-mode CLI could swallow the wheel, so drive scrollback directly.
+      if(!hasToken){e.preventDefault();e.stopPropagation();term.scrollLines(e.deltaY>0?3:-3);}
+      return;
+    }
+    e.preventDefault();e.stopPropagation();
+    // Normalise deltaMode to px: line→~16px, page→~one screen.
+    var px=e.deltaMode===1?e.deltaY*16:e.deltaMode===2?e.deltaY*term.rows*16:e.deltaY;
+    _fwdScroll(px);
+  },{capture:true,passive:false});
 }
 
 // ── Touch shortcut toolbar ──
@@ -5238,11 +5286,29 @@ if(isTouch&&hasToken){
   }
 }
 
-// Single-finger touch scrolling is handled natively by xterm's own Viewport
-// (handleTouchMove → scrollTop), so no custom handler here — a parallel one
-// would double-drive scrollTop and fight xterm.  overscroll-behavior:none on
-// .xterm-viewport (see <style>) kills the iOS rubber-band; the WebGL/Canvas
-// renderer above is what actually makes scrolling over text smooth.
+// Single-finger touch scrolling: normal-buffer CLIs use xterm's own Viewport
+// (handleTouchMove → scrollTop) natively. Alt-screen CLIs (Claude) have no xterm
+// scrollback, so native touch scroll does nothing — mirror the wheel fix and
+// forward the drag to the CLI as SGR wheel events so it scrolls its own
+// transcript. Only the alternate buffer is intercepted (capture + stopPropagation);
+// the normal buffer falls through to xterm untouched, so no double-drive of
+// scrollTop. overscroll-behavior:none (see <style>) kills the iOS rubber-band.
+if(!${isTmuxMode && !isPipeMode}){
+  var _tTerm=document.getElementById('terminal');
+  var _tLastY=null;
+  _tTerm.addEventListener('touchstart',function(e){
+    if(e.touches.length===1)_tLastY=e.touches[0].clientY;
+  },{capture:true,passive:true});
+  _tTerm.addEventListener('touchmove',function(e){
+    // Normal buffer / multi-touch / no start → let xterm (or the browser) handle it.
+    if(term.buffer.active.type!=='alternate'||_tLastY===null||e.touches.length!==1)return;
+    e.preventDefault();e.stopPropagation();
+    var y=e.touches[0].clientY;
+    _fwdScroll(_tLastY-y); // finger drags down (y grows) → px<0 → scroll up (history)
+    _tLastY=y;
+  },{capture:true,passive:false});
+  _tTerm.addEventListener('touchend',function(){_tLastY=null;},{capture:true,passive:true});
+}
 </script>
 </body>
 </html>`;