@xgjktech/xg-openclaw-harness-tools 0.4.8 → 0.4.9

package/dist/plan-write-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-write-tool.d.ts","sourceRoot":"","sources":["../src/plan-write-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,SAAS,EAGf,MAAM,8BAA8B,CAAC;AAkCtC,eAAO,MAAM,eAAe;;;;;;;;;EAwB3B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,sBAAsB,QA4BvB,CAAC;AA0Eb,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,YAAY,CA2HtF"}
+{"version":3,"file":"plan-write-tool.d.ts","sourceRoot":"","sources":["../src/plan-write-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,SAAS,EAGf,MAAM,8BAA8B,CAAC;AAkCtC,eAAO,MAAM,eAAe;;;;;;;;;EAwB3B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,sBAAsB,QA6BvB,CAAC;AA+Gb,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,YAAY,CA4ItF"}

package/dist/plan-write-tool.js

@@ -62,6 +62,7 @@ export const PLAN_WRITE_DESCRIPTION = [
     "- 更新计划内容时必须重新提交 goal 和所有要保留的 tasks，包括未变化任务及其当前 status/note。只提交变化项会删除其他任务；记不清时先用 xg_plan_view 查看。",
     "- goal 用一句话；tasks 通常 3-7 项，每项是能判断是否完成的具体动作，不写 TODO、待定或内部思考。",
     "- status 为 pending、in_progress、completed 或 blocked。通常只有一项 in_progress，确实并行时可以有多项；blocked 时必须用 note 写明原因和继续所需条件。",
+    "- 已完成任务不可回退：一旦某项标记 completed，后续回写必须保持 completed，禁止改回 pending/in_progress/blocked。若执行中发现此前完成结论不成立或需返工，保留该 completed 项（可在 note 中说明返工原因），新增一条后续任务承接返工/补做，并相应调整其后的步骤。",
     "- 同一件工作只维护一份计划；任务方向变化时，先取消不再推进的旧计划（{planId, cancel:true}）再新建。",
 ].join("\n");
 function toTask(input) {
@@ -74,6 +75,32 @@ function toTask(input) {
     }
     return task;
 }
+function normalizeTaskTitle(title) {
+    return title.trim();
+}
+/**
+ * 检测"已完成任务被回退"：以规范化标题对齐旧任务与新提交任务，
+ * 凡旧任务为 completed 而新提交同名任务状态不再是 completed，即为回退。
+ * 同名任务整体删除属于整张覆盖语义（未提交即删除），不算回退。
+ */
+function findTaskStatusRegressions(existing, nextTasks) {
+    const completedTitles = new Set();
+    for (const task of existing.tasks) {
+        if (task.status === "completed") {
+            completedTitles.add(normalizeTaskTitle(task.title));
+        }
+    }
+    const regressions = [];
+    for (const task of nextTasks) {
+        const nextStatus = (task.status ?? "pending");
+        if (nextStatus === "completed")
+            continue;
+        if (completedTitles.has(normalizeTaskTitle(task.title))) {
+            regressions.push({ title: task.title, from: "completed", to: nextStatus });
+        }
+    }
+    return regressions;
+}
 function buildPlan(goal, tasks, existing, planId, origin, now) {
     const plan = {
         planId,
@@ -191,6 +218,21 @@ export function buildPlanWriteTool(store, origin) {
                         return toolJsonResult(result);
                     }
                 }
+                if (existing !== undefined) {
+                    const regressions = findTaskStatusRegressions(existing, params.tasks);
+                    if (regressions.length > 0) {
+                        const detail = `${regressions
+                            .map((regression) => `「${compactText(regression.title)}」${regression.from} → ${regression.to}`)
+                            .join("；")}。` +
+                            "已完成任务禁止回退：若执行中发现此前完成结论不成立或需返工，请保留该 completed 项，" +
+                            "新增一条后续任务说明补救/返工动作并相应调整后续步骤，而不是把已完成项改回未完成。";
+                        const result = {
+                            ok: false,
+                            error: { code: "TASK_STATUS_REGRESSION", detail },
+                        };
+                        return toolJsonResult(result);
+                    }
+                }
                 let warnings;
                 if (planIdParam === undefined && scope !== undefined) {
                     const warning = unfinishedPlanWarning(store.listPlansByOrigin(scope), Date.now());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xgjktech/xg-openclaw-harness-tools",
-  "version": "0.4.8",
+  "version": "0.4.9",
   "description": "企业工具插件：plan_write / plan_view / action_dispatch（OpenClaw 第三方工具插件）",
   "license": "MIT",
   "type": "module",