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

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA+BA,QAAA,MAAM,WAAW,kEA6Df,CAAC;AAaH,eAAe,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiDA,QAAA,MAAM,WAAW,kEAkEf,CAAC;AAeH,eAAe,WAAW,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
+import { Type } from "typebox";
 import { defineToolPlugin } from "openclaw/plugin-sdk/tool-plugin";
 import { isSubagentSessionKey } from "openclaw/plugin-sdk/routing";
 import { resolvePlanDbPath, SqlitePlanStore, SqliteActionStore } from "@xgjktech/xg-openclaw-shared";
@@ -7,6 +8,18 @@ import { ACTION_DISPATCH_DESCRIPTION, ActionDispatchParams, buildActionDispatchT
 import { toPlanOrigin } from "./plan-origin.js";
 import { buildPlanPromptInjection } from "./plan-prompt.js";
 const PLUGIN_ID = "xg-harness-tools";
+// 计划功能总开关：默认 false（关闭 xg_plan_write / xg_plan_view 及主动建计划 prompt 注入）。
+// 代码与测试保留，部署时在插件配置里设 { "enablePlan": true } 即可重新启用。
+const PluginConfigSchema = Type.Object({
+    enablePlan: Type.Optional(Type.Boolean({
+        default: false,
+        description: "启用 xg 计划工具（xg_plan_write / xg_plan_view）与主动建计划 prompt 注入。默认 false。",
+    })),
+});
+/** 计划功能是否启用：仅显式 true 才开启，缺省/其他值一律视为关闭。 */
+function isPlanEnabled(pluginConfig) {
+    return pluginConfig?.enablePlan === true;
+}
 // 临时诊断日志：确认 subagent 会话的 sessionKey 是否到达 hook/tool factory 且判定正确。确认后删除。
 function logPlanGate(api, tag, sessionKey) {
     api.runtime?.logging
@@ -20,6 +33,7 @@ const pluginEntry = defineToolPlugin({
     id: PLUGIN_ID,
     name: "XG Harness Tools",
     description: "企业工具插件：计划管理与通用动作分发（plan_write / plan_view / action_dispatch）",
+    configSchema: PluginConfigSchema,
     tools: (tool) => {
         let planStore;
         let actionStore;
@@ -44,9 +58,12 @@ const pluginEntry = defineToolPlugin({
                 description: PLAN_WRITE_DESCRIPTION,
                 parameters: PlanWriteParams,
                 optional: true,
-                factory: ({ api, toolContext }) => {
-                    // 计划只允许主 agent 维护；subagent 会话不注册计划工具，杜绝其建计划。
+                factory: ({ api, config, toolContext }) => {
+                    // 计划功能默认关闭；仅显式 enablePlan:true 时注册。
                     logPlanGate(api, "plan_write_factory", toolContext.sessionKey);
+                    if (!config.enablePlan)
+                        return null;
+                    // 计划只允许主 agent 维护；subagent 会话不注册计划工具，杜绝其建计划。
                     if (isSubagentSessionKey(toolContext.sessionKey))
                         return null;
                     return buildPlanWriteTool(getPlanStore(api), toPlanOrigin(toolContext));
@@ -58,8 +75,11 @@ const pluginEntry = defineToolPlugin({
                 description: PLAN_VIEW_DESCRIPTION,
                 parameters: PlanViewParams,
                 optional: true,
-                factory: ({ api, toolContext }) => {
+                factory: ({ api, config, toolContext }) => {
+                    // 计划功能默认关闭；仅显式 enablePlan:true 时注册。
                     logPlanGate(api, "plan_view_factory", toolContext.sessionKey);
+                    if (!config.enablePlan)
+                        return null;
                     if (isSubagentSessionKey(toolContext.sessionKey))
                         return null;
                     return buildPlanViewTool({ store: getPlanStore(api), origin: toPlanOrigin(toolContext) });
@@ -81,6 +101,9 @@ const pluginEntry = defineToolPlugin({
 const baseRegister = pluginEntry.register;
 pluginEntry.register = (api) => {
     baseRegister(api);
+    // 计划功能默认关闭时，不注入主动建计划纪律。
+    if (!isPlanEnabled(api.pluginConfig))
+        return;
     api.on("before_prompt_build", (event, ctx) => {
         logPlanGate(api, "hook", ctx.sessionKey);
         return buildPlanPromptInjection(event, ctx);

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/openclaw.plugin.json

@@ -6,7 +6,13 @@
   "configSchema": {
     "type": "object",
     "additionalProperties": true,
-    "properties": {}
+    "properties": {
+      "enablePlan": {
+        "type": "boolean",
+        "default": false,
+        "description": "启用 xg 计划工具（xg_plan_write / xg_plan_view）与主动建计划 prompt 注入。默认 false。"
+      }
+    }
   },
   "contracts": {
     "tools": ["xg_plan_write", "xg_plan_view", "xg_action_dispatch"]

package/package.json

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