dsh-foreman 0.3.1 → 0.3.2

package/CHANGELOG.md

@@ -6,6 +6,20 @@
 
 本项目自己的版本从 `0.1.0` 开始。
 
+## 0.3.2 — 2026-11-08
+
+### 修复：派单文本没有说要回报
+
+真机上一次派单，设备做了 30 步、写完整答案，**一次都没调用 `foreman_report`**——因为派单文本里
+根本没提这件事。设备收到的只有标题、请求原文和附件说明，模型自然当成普通任务做完就停，
+hub 于是永远停在 `running`。
+
+现在每张派单的末尾都有一段：`foreman_report` 是结果到达问话人的唯一途径，答在对话里
+不算完成，**没回报就不算做完**。
+
+配套地，设备侧 `dsh-foreman-node@0.2.1` 加了一层兜底：一轮结束而还没回报时自动补一条
+`ready`。两层一起，模型照做时走正路，不照做也不会让工单挂死。
+
 ## 0.3.1 — 2026-11-08
 
 ### 修复：同一 id 的两个连接互相踢，设备永远上不了线

package/lib/index.js

@@ -9622,6 +9622,20 @@ function attachmentSection(names) {
 *
 * @throws When the attachments together exceed the frame budget: a truncated task would be worse than a refused one.
 */
+/**
+* What a device is told about reporting, appended to every assignment.
+*
+* Without it the job Session simply answers and stops: on a real deployment a device did thirty steps of real work,
+* wrote a complete answer, and never called `foreman_report`, so the hub sat at `running` with no report forever and
+* a person saw a job that never finished. The tool exists, but nothing told the model it was required or final.
+*/
+const REPORT_SECTION = [
+	"\n## Reporting back\n",
+	"\nWhen you have finished, call `foreman_report` — that tool is how this job reaches the person who asked, and ",
+	"answering in chat does not reach them. Report `ready` with a one-sentence summary of the result, or `blocked` with ",
+	"the one question only they can answer, or `failed` if the work cannot be done. The job is not finished until you ",
+	"have reported.\n"
+].join("");
 function renderForDevice(input) {
 	const { ticket, trigger } = input;
 	const refs = refsOf(trigger);
@@ -9645,7 +9659,8 @@ function renderForDevice(input) {
 			`# ${ticket.title}`,
 			scope === "" ? "" : `\n${scope}\n`,
 			request === "" ? "" : `\n## The request as it was written\n\n${request}\n`,
-			attachmentSection(attachments.map((attachment) => attachment.name ?? attachment.id))
+			attachmentSection(attachments.map((attachment) => attachment.name ?? attachment.id)),
+			REPORT_SECTION
 		].filter((section) => section !== "").join(""),
 		attachments
 	};

package/package.json

@@ -2,7 +2,7 @@
   "name": "dsh-foreman",
   "author": "niechao136",
   "license": "MIT",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "dsh-foreman：主 loop 在多设备上派单的 DSH bundle：需求来自本机操作者的主会话而不是 GitHub/飞书，每个工作区各有一条主会话，主会话只负责路由，真正的活儿派给 Worker 在该工作区目录里执行。",
   "type": "module",
   "main": "lib/index.js",
@@ -62,7 +62,7 @@
   },
   "packageManager": "pnpm@11.7.0",
   "dependencies": {
-    "dsh-foreman-node": "0.2.0",
+    "dsh-foreman-node": "0.2.1",
     "proper-lockfile": "4.1.2",
     "ws": "8.22.0",
     "zod": "4.4.3"