@stalfh233/omc-cli 0.4.41 → 0.4.43

package/dist/lanes/list-view.js

@@ -263,6 +263,28 @@ export function registerListViewLane(tools) {
             };
         }),
     }));
+    const listviewRollbackSpec = (toolName) => ({
+        target: (args) => `listview:${String(args.schemaCode ?? "")}/${String(args.code ?? args.schemaCode ?? "")}`,
+        read: async (session, args) => {
+            const code = String(args.code ?? args.schemaCode);
+            const got = await wireCall(session, { path: ENDPOINTS.listQueryGet, query: { schemaCode: String(args.schemaCode), code, clientType: "PC" } });
+            const model = (got.data ?? null);
+            return model && model.id ? model : null;
+        },
+        inverse: ({ before, args }) => {
+            const schemaCode = String(args.schemaCode);
+            const code = String(args.code ?? schemaCode);
+            if (toolName === "listview.create")
+                return before == null ? { kind: "calls", calls: [{ tool: "listview.delete", args: { schemaCode, code } }] } : { kind: "calls", calls: [], notes: ["create 前视图已存在，未写入"] };
+            if (before == null)
+                return { kind: "calls", calls: [], notes: ["目标在写入前不存在，无法恢复"] };
+            const row = before;
+            const configure = { schemaCode, code, fieldCodes: readArray(row, "queryColumns").map((column) => String(column.propertyCode ?? "")).filter(Boolean), ...(row.querySorts !== undefined ? { sorts: row.querySorts } : {}), ...(row.queryConditions !== undefined ? { conditions: row.queryConditions } : {}), ...(row.queryActions !== undefined ? { actions: row.queryActions, replaceActions: true } : {}), ...(row.queryPresentation !== undefined ? { presentation: row.queryPresentation } : {}), ...(row.options !== undefined ? { options: parseConditionOptions(row.options) } : {}), ...(row.queryPresentationType !== undefined ? { presentationType: row.queryPresentationType } : {}), ...(row.queryGanttModel !== undefined ? { gantt: row.queryGanttModel } : {}), ...(row.queryLayer !== undefined ? { queryLayer: row.queryLayer } : {}), ...(row.multiTableHeaderConfig !== undefined ? { multiTableHeaderConfig: parseConditionOptions(row.multiTableHeaderConfig) } : {}) };
+            if (toolName === "listview.configure")
+                return { kind: "calls", calls: [{ tool: "listview.configure", args: configure }] };
+            return { kind: "calls", calls: [{ tool: "listview.create", args: { schemaCode, code, name: String(row.name ?? code) } }, { tool: "listview.configure", args: configure }], notes: ["删除后重建视图，平台 id 不保证一致"] };
+        },
+    });
     tools.push(defineTool({
         name: "listview.list",
         layer: "low",
@@ -308,7 +330,7 @@ export function registerListViewLane(tools) {
                 throw error;
             return { performed: { skipped: "already-present" }, readback: { alreadyPresent: true, header: header.data } };
         }
-    });
+    }, undefined, undefined, listviewRollbackSpec("listview.create"));
     writeTool(tools, "listview.configure", LIST_VIEW_LANE, LIST_VIEW_TOOLS["listview.configure"].scope, LIST_VIEW_TOOLS["listview.configure"].description, {
         schemaCode: z.string().min(1),
         code: z.string().optional(),
@@ -569,7 +591,7 @@ export function registerListViewLane(tools) {
             readback.multiTableHeaderConfig = parseConditionOptions(afterModel.multiTableHeaderConfig);
         }
         return { performed: { errcode: performed.errcode }, readback };
-    }, assertListViewConfigureShape);
+    }, assertListViewConfigureShape, undefined, listviewRollbackSpec("listview.configure"));
     writeTool(tools, "listview.delete", LIST_VIEW_LANE, LIST_VIEW_TOOLS["listview.delete"].scope, LIST_VIEW_TOOLS["listview.delete"].description, { schemaCode: z.string().min(1), code: z.string().min(1) }, async (session, args) => {
         const before = await wireCall(session, { path: ENDPOINTS.listQueryGetHeader, query: { schemaCode: args.schemaCode, code: args.code } });
         if (before.data == null)
@@ -577,6 +599,6 @@ export function registerListViewLane(tools) {
         const performed = await wireCall(session, { path: ENDPOINTS.listQueryDelete, method: "POST", query: { schemaCode: args.schemaCode, code: args.code } });
         const readback = await wireCall(session, { path: ENDPOINTS.listQueryGetHeader, query: { schemaCode: args.schemaCode, code: args.code } });
         return { performed: { errcode: performed.errcode }, readback: { absent: readback.data == null, header: readback.data ?? null } };
-    });
+    }, undefined, undefined, listviewRollbackSpec("listview.delete"));
 }
 //# sourceMappingURL=list-view.js.map

package/dist/lanes/model.js

@@ -17,6 +17,35 @@ import { wireCall, wireRows, WireError } from "../wire.js";
 import { MODEL_CREATE_BODY_DEFAULTS, MODEL_LANE_CONTRACT } from "./model-contract.js";
 const MODEL_LANE = MODEL_LANE_CONTRACT.lane;
 const MODEL_TOOLS = MODEL_LANE_CONTRACT.tools;
+function modelRollbackSpec(toolName) {
+    return {
+        target: (args) => `model:${String(args.schemaCode ?? args.code ?? "")}`,
+        read: async (session, args) => {
+            const resolved = await resolveModelTreeNode(session, String(args.schemaCode ?? args.code));
+            const record = (await wireCall(session, { path: ENDPOINTS.modelGet, query: { schemaCode: String(args.schemaCode ?? args.code) } })).data;
+            if (!resolved.node && !record)
+                return null;
+            return { node: resolved.node ?? null, record: record ?? null };
+        },
+        inverse: ({ before, args }) => {
+            const code = String(args.schemaCode ?? args.code);
+            if (toolName === "model.create") {
+                // before null = the model did not exist → the rollback DELETES what
+                // this write created; before present = idempotent already-present
+                // skip → nothing to undo.
+                if (before == null)
+                    return { kind: "calls", calls: [{ tool: "model.delete", args: { schemaCode: code } }] };
+                return { kind: "calls", calls: [], notes: ["create 时已存在（幂等跳过），未写入，无需回滚"] };
+            }
+            if (before == null)
+                return { kind: "calls", calls: [] };
+            const snapshot = before;
+            if (toolName === "model.update")
+                return { kind: "calls", calls: snapshot.node?.name === undefined ? [] : [{ tool: "model.update", args: { schemaCode: code, name: String(snapshot.node.name) } }] };
+            return { kind: "calls", calls: [{ tool: "model.create", args: { code, name: String(snapshot.node?.name ?? snapshot.record?.name ?? code) } }], notes: ["字段/表单/视图不随行恢复，需重建"] };
+        },
+    };
+}
 /**
  * Ticket 68 — locate a model's app-tree node across applications. The app
  * tree row id is the AppFunction id that `apppackage/physically_delete`
@@ -344,7 +373,7 @@ export function registerModelLane(tools) {
         });
         const present = flattenTreeRows(wireRows((await wireCall(session, { path: ENDPOINTS.applicationTree, query: { appCode: applicationCode } })).data)).some((row) => row.type === "BizModel" && row.code === args.code);
         return { performed: { errcode: performed.errcode, folderId, resolvedFrom, applicationCode }, readback: { present } };
-    });
+    }, undefined, undefined, modelRollbackSpec("model.create"));
     /** model.delete writeTool extra arg: a session-aware dry-run that scans inbound references (no write). */
     async function modelDeleteDryRun(session, args) {
         const record = await (async () => {
@@ -493,7 +522,7 @@ export function registerModelLane(tools) {
                     }),
             },
         };
-    }, undefined, modelDeleteDryRun);
+    }, undefined, modelDeleteDryRun, modelRollbackSpec("model.delete"));
     writeTool(tools, "model.deleteMany", MODEL_LANE, MODEL_TOOLS["model.deleteMany"].scope, MODEL_TOOLS["model.deleteMany"].description, { schemaCodes: z.array(z.string().min(1)).min(1), applicationCode: z.string().optional() }, async (session, args) => {
         // Platform evidence: physically_delete takes the WHOLE list in ONE
         // request (AppPackageController.java:1424 @RequestBody
@@ -734,7 +763,7 @@ export function registerModelLane(tools) {
                 schemaCode: raw.schemaCode,
                 message: "模型类型在创建时固化——bizmodels/update 只更新应用菜单节点显示，不能把底层 schema 从 LIST 迁移为 TREE（get_all 仍返回原类型与树系统字段，live 取证）。要树模型请建新模型",
             });
-    });
+    }, undefined, modelRollbackSpec("model.update"));
     registerPackageTool(tools, {
         name: "configure_model",
         lane: MODEL_LANE,

package/dist/lanes/online-js-contract.js

@@ -72,9 +72,13 @@ export const ONLINE_JS_LANE_CONTRACT = Object.freeze({
         "packages/omc-cli/test/issue-11-online-js.test.ts",
     ]),
     tools: Object.freeze({
+        "onlinejs.get": Object.freeze({
+            scope: "draft published script readback",
+            description: "Read the form's Online JS script WITHOUT pulling the whole six-JSON full body: extracts the customScript element from draftHtmlJson and publishedHtmlJson and returns each face's innerHTML verbatim (the platform lifecycle wrapper included — that IS the stored script), plus SHA-256 for change detection and a present marker when the sheet/script does not exist yet. Use this to inspect existing script before onlinejs.compose (replace vs INCREMENTAL decision), or to verify a compose landed; the compose tool's own readback fingerprints the same bytes.",
+        }),
         "onlinejs.compose": Object.freeze({
             scope: ONLINE_JS_SCOPE,
-            description: `Compose the Online JS source as the customScript element into the form's draftHtmlJson layout array (then publish, promoting it verbatim to publishedHtmlJson). Core contract: preserve the platform template and only extend customScript.innerHTML — the six-element skeleton includes the ${PLATFORM_LIFECYCLE_WRAPPER_MARKER} lifecycle wrapper; the style, toolbar, template, beforeCustomScript, customScript, and afterCustomScript elements are kept or synthesized with platform defaults, while every layout/control element is preserved. customScript is rebuilt canonically as {tagName:'script', id:'customScript', innerHTML:<platform lifecycle wrapper containing source>, attrs:[]} because the designer requires an ARRAY attrs (e.attrs.some) and tagName, else the Online JS editor fails with t.some is not a function. Drives bizsheet/update + bizsheet/publish; publishedHtmlJson is read back verbatim and SHA-256-fingerprinted so the caller can verify byte equality. Never overwrites the layout with a standalone script object or a partial [customScript]-only array (regression for issue 11's root cause).`,
+            description: `Compose the Online JS source as the customScript element into the form's draftHtmlJson layout array (then publish, promoting it verbatim to publishedHtmlJson). Core contract: preserve the platform template and only extend customScript.innerHTML — the six-element skeleton includes the ${PLATFORM_LIFECYCLE_WRAPPER_MARKER} lifecycle wrapper; the style, toolbar, template, beforeCustomScript, customScript, and afterCustomScript elements are kept or synthesized with platform defaults, while every layout/control element is preserved. customScript is rebuilt canonically as {tagName:'script', id:'customScript', innerHTML:<platform lifecycle wrapper containing source>, attrs:[]} because the designer requires an ARRAY attrs (e.attrs.some) and tagName, else the Online JS editor fails with t.some is not a function. Drives bizsheet/update + bizsheet/publish; publishedHtmlJson is read back verbatim and SHA-256-fingerprinted so the caller can verify byte equality. Read the EXISTING script first with onlinejs.get (decide replace vs INCREMENTAL from what is actually stored). Never overwrites the layout with a standalone script object or a partial [customScript]-only array (regression for issue 11's root cause).`,
         }),
     }),
 });
@@ -93,6 +97,7 @@ export function assertOnlineJsContract() {
     if (!ONLINE_JS_WIRE.composeElement.includes(PLATFORM_LIFECYCLE_WRAPPER_MARKER))
         throw new Error("online-js contract must pin the platform lifecycle wrapper");
     assertDescriptionCarries(ONLINE_JS_LANE_CONTRACT, "onlinejs.compose", ["customScript", "draftHtmlJson", "publishedHtmlJson", "SHA-256", "issue 11", PLATFORM_LIFECYCLE_WRAPPER_MARKER]);
+    assertDescriptionCarries(ONLINE_JS_LANE_CONTRACT, "onlinejs.get", ["customScript", "draftHtmlJson", "publishedHtmlJson", "SHA-256"]);
     if ("onlinejs.draft" in ONLINE_JS_LANE_CONTRACT.tools || "onlinejs.publish" in ONLINE_JS_LANE_CONTRACT.tools)
         throw new Error("online-js contract must not carry the removed programming tools");
 }

package/dist/lanes/online-js-coverage.js

@@ -22,7 +22,7 @@ export const ONLINE_JS_COVERAGE = declareLaneCoverage(ONLINE_JS_LANE_CONTRACT.la
             ".scratch/omc-route-wayfinder/leg4-closeout.md",
             "packages/omc-cli/test/ticket-73-onlinejs-template-fidelity.test.ts",
         ],
-        tools: [claim("onlinejs.compose", T["onlinejs.compose"].scope)],
+        tools: [claim("onlinejs.compose", T["onlinejs.compose"].scope), claim("onlinejs.get", T["onlinejs.get"].scope)],
     },
 ]);
 //# sourceMappingURL=online-js-coverage.js.map

package/dist/lanes/online-js.js

@@ -1,8 +1,11 @@
 import { z } from "zod";
 import { createHash } from "node:crypto";
 import { ENDPOINTS } from "../endpoints.js";
-import { assertHtmlRender, executeFormDraftWrite, executeFormPublishWrite, validateHtmlRender } from "../form-support.js";
+import { assertHtmlRender, executeFormDraftWrite, executeFormPublishWrite, readFormOrNull, validateHtmlRender } from "../form-support.js";
+import { capabilityArg, environmentArg } from "../args.js";
 import { writeTool } from "../write.js";
+import { governedRead } from "../read.js";
+import { defineTool } from "../tool-types.js";
 import { wireCall } from "../wire.js";
 import { composeCustomScript, lintOnlineJsSource } from "../online-js-source.js";
 import { composeLayoutElements } from "../online-js-layout.js";
@@ -40,7 +43,58 @@ function parseLayoutElements(rawHtml) {
  * section is what convertElement keys on (id === "template") to render the
  * template area — omitting toolbar/template leaves the panel regions empty.
  */
+/** Extract the customScript element's innerHTML from a layout-JSON face; null when absent. */
+function readCustomScriptSource(rawHtml) {
+    const elements = parseLayoutElements(rawHtml);
+    // Match by id ONLY: beforeCustomScript/afterCustomScript are also
+    // tagName:'script' elements with an empty innerHTML and would shadow the
+    // real script when the find falls back to the tag name.
+    const element = elements.find((candidate) => candidate.id === "customScript");
+    const script = typeof element?.innerHTML === "string" && element.innerHTML.trim() !== "" ? element.innerHTML : null;
+    return { present: script !== null, script, sha256: script !== null ? createHash("sha256").update(script, "utf8").digest("hex") : null, elementCount: elements.length };
+}
 export function registerOnlineJsLane(tools) {
+    tools.push(defineTool({
+        name: "onlinejs.get",
+        layer: "low",
+        kind: "read",
+        lane: ONLINE_JS_LANE,
+        scope: ONLINE_JS_TOOLS["onlinejs.get"].scope,
+        description: ONLINE_JS_TOOLS["onlinejs.get"].description,
+        inputSchema: {
+            environment: environmentArg,
+            schemaCode: z.string().min(1),
+            sheetCode: z.string().min(1).optional().describe("表单槽位码；省略时默认 = schemaCode（模型码即默认表单槽位）；多表单模型显式传"),
+            capability: capabilityArg,
+        },
+        handler: async (ctx, args, self) => governedRead(ctx, self, args, async (session) => {
+            const sheetCode = args.sheetCode ?? args.schemaCode;
+            const sheet = await readFormOrNull(session, args.schemaCode, sheetCode);
+            if (sheet === null)
+                return { schemaCode: args.schemaCode, sheetCode, present: false, hint: "表单不存在——先 form.draft/表单创建" };
+            const draft = readCustomScriptSource(typeof sheet.draftHtmlJson === "string" ? sheet.draftHtmlJson : null);
+            const published = readCustomScriptSource(typeof sheet.publishedHtmlJson === "string" ? sheet.publishedHtmlJson : null);
+            return {
+                schemaCode: args.schemaCode,
+                sheetCode,
+                present: true,
+                sheetPublished: sheet.published === true,
+                draft: { ...draft, ...(draft.script === null ? { note: "草稿无 customScript 脚本（尚未 compose 或被清空）" } : {}) },
+                published: { ...published, ...(published.script === null ? { note: "发布面无 customScript 脚本" } : {}) },
+                ...(draft.sha256 !== null && published.sha256 !== null
+                    ? { draftPublishedInSync: draft.sha256 === published.sha256 }
+                    : {}),
+                hint: "脚本是 innerHTML 原文（含平台 (function(form){…}) 生命周期包装——那就是平台存储形态）；改脚本用 onlinejs.compose（默认 INCREMENTAL 并入，replace:true 整段替换）；同文件修订直接 replace:true 传完整脚本",
+            };
+        }, {
+            target: `onlinejs.get:${args.schemaCode}/${args.sheetCode ?? args.schemaCode}`,
+            // The script IS the payload of this read: keep it inline past the
+            // generic 4 KB diet (compactReadback would replace the faces with key
+            // counts and force an artifact round-trip — the exact friction this
+            // tool exists to remove).
+            compact: (result) => result,
+        }),
+    }));
     writeTool(tools, "onlinejs.compose", ONLINE_JS_LANE, ONLINE_JS_TOOLS["onlinejs.compose"].scope, ONLINE_JS_TOOLS["onlinejs.compose"].description, {
         schemaCode: z.string().min(1),
         sheetCode: z.string().min(1),
@@ -122,6 +176,29 @@ export function registerOnlineJsLane(tools) {
     // Refuse a source that cannot run in the script slot (export/import, unknown
     // form.on event) BEFORE the write permission gate. This is the exact
     // class of mistake that blanked a live form page with no harness signal.
-    (args) => lintOnlineJsSource(args.source));
+    (args) => lintOnlineJsSource(args.source), undefined, {
+        target: (args) => `onlinejs:${String(args.schemaCode ?? "")}/${String(args.sheetCode ?? args.schemaCode ?? "")}`,
+        read: async (session, args) => {
+            const sheet = await readFormOrNull(session, String(args.schemaCode), String(args.sheetCode ?? args.schemaCode));
+            if (!sheet)
+                return null;
+            const raw = typeof sheet.draftHtmlJson === "string" ? sheet.draftHtmlJson : "";
+            let elements = [];
+            try {
+                const parsed = JSON.parse(raw);
+                if (Array.isArray(parsed))
+                    elements = parsed;
+            }
+            catch { }
+            const script = elements.find((element) => element && typeof element === "object" && element.id === "customScript");
+            return { customScript: typeof script?.innerHTML === "string" ? script.innerHTML : null };
+        },
+        inverse: ({ before, args }) => {
+            const source = before?.customScript;
+            if (typeof source !== "string")
+                return { kind: "irreversible", reason: "before 表单没有可识别的 customScript element，无法构造清空脚本的等价 compose 调用" };
+            return { kind: "calls", calls: [{ tool: "onlinejs.compose", args: { schemaCode: String(args.schemaCode), sheetCode: String(args.sheetCode ?? args.schemaCode), source, replace: true, publish: args.publish } }] };
+        },
+    });
 }
 //# sourceMappingURL=online-js.js.map

package/dist/lanes/report.js

@@ -9,6 +9,32 @@ import { biCall, DEFAULT_BI_CORP_ID } from "../bi-wire.js";
 import { REPORT_LANE_CONTRACT } from "./report-contract.js";
 const LANE = REPORT_LANE_CONTRACT.lane;
 const TOOLS = REPORT_LANE_CONTRACT.tools;
+function reportRollbackSpec(toolName) {
+    return {
+        target: (args) => `report:${String(args.code ?? args.reportCode ?? "")}`,
+        read: async (session, args) => {
+            const code = String(args.code ?? args.reportCode);
+            const page = (await wireCall(session, { path: ENDPOINTS.reportGet, query: { code } })).data;
+            if (!page || !page.id)
+                return null;
+            const auth = authOf(args.corpId, code, String(args.appCode ?? page.appCode ?? ""));
+            const bi = await readBiConfig(session, auth, String(page.id));
+            return { page, bi };
+        },
+        inverse: ({ before, args }) => {
+            if (toolName === "report.create")
+                return before == null ? { kind: "calls", calls: [{ tool: "report.delete", args: { code: String(args.code) } }] } : { kind: "calls", calls: [], notes: ["报表已存在，create 未写入"] };
+            if (before == null)
+                return { kind: "calls", calls: [] };
+            const snapshot = before;
+            if (toolName === "report.update")
+                return { kind: "calls", calls: [{ tool: "report.update", args: { code: String(args.code), ...(snapshot.page.name !== undefined ? { name: snapshot.page.name } : {}), ...(snapshot.page.icon !== undefined ? { icon: snapshot.page.icon } : {}), ...(snapshot.page.parentId !== undefined ? { parentId: snapshot.page.parentId } : {}), ...(snapshot.page.pcAble !== undefined ? { pcAble: snapshot.page.pcAble } : {}), ...(snapshot.page.mobileAble !== undefined ? { mobileAble: snapshot.page.mobileAble } : {}) } }] };
+            if (toolName === "report.configure")
+                return { kind: "calls", calls: [{ tool: "report.configure", args: { reportCode: String(args.reportCode), appCode: String(args.appCode), charts: snapshot.bi.charts, global: snapshot.bi.global, attributes: snapshot.bi.attributes, removeUnlistedCharts: true, ...(args.corpId ? { corpId: args.corpId } : {}) } }] };
+            return { kind: "calls", calls: [{ tool: "report.create", args: { code: String(snapshot.page.code), name: String(snapshot.page.name), appCode: String(snapshot.page.appCode), parentId: String(snapshot.page.parentId) } }], notes: ["删除后重建报表页，平台 id/dashboard id 不保证一致"] };
+        },
+    };
+}
 /**
  * The default BI dashboard `global` (theme21). A brand-new report page has no
  * BI dashboard record until it is saved, and the BI save requires a `global`
@@ -360,7 +386,7 @@ export function registerReportLane(tools) {
             performed: { errcode: 0, code, appCode: args.appCode, objectId },
             readback: { present: page.code === code, report: reportPageView(page), biInitialized: objectId !== "" },
         };
-    }, (args) => requireCode(args.code));
+    }, (args) => requireCode(args.code), undefined, reportRollbackSpec("report.create"));
     writeTool(tools, "report.update", LANE, TOOLS["report.update"].scope, TOOLS["report.update"].description, {
         code: z.string().min(1),
         name: z.string().min(1).max(60).optional(),
@@ -391,7 +417,7 @@ export function registerReportLane(tools) {
         });
         const after = (await wireCall(session, { path: ENDPOINTS.reportGet, query: { code: args.code } })).data;
         return { performed: { errcode: performed.errcode }, readback: { present: Boolean(after && after.code), report: reportPageView(after) } };
-    });
+    }, undefined, undefined, reportRollbackSpec("report.update"));
     writeTool(tools, "report.delete", LANE, TOOLS["report.delete"].scope, TOOLS["report.delete"].description, {
         code: z.string().min(1),
         corpId: z.string().optional(),
@@ -418,7 +444,7 @@ export function registerReportLane(tools) {
         collectReports(tree, remaining);
         const stillListed = remaining.some((report) => report.code === args.code);
         return { performed: { errcode: performed.errcode, code: args.code, dashboardRemoved }, readback: { absent: !stillListed, remainingInTree: stillListed } };
-    });
+    }, undefined, undefined, reportRollbackSpec("report.delete"));
     writeTool(tools, "report.configure", LANE, TOOLS["report.configure"].scope, TOOLS["report.configure"].description, {
         reportCode: z.string().min(1),
         appCode: z.string().min(1),
@@ -473,6 +499,6 @@ export function registerReportLane(tools) {
                 attributesPresent: after.attributes !== undefined && JSON.stringify(after.attributes) !== "{}",
             },
         };
-    });
+    }, undefined, undefined, reportRollbackSpec("report.configure"));
 }
 //# sourceMappingURL=report.js.map

package/dist/lanes/rule-lifecycle.js

@@ -10,6 +10,31 @@ import { wireCall, wireRows, WireError } from "../wire.js";
 import { RULE_ENABLE_CHAIN, RULE_LIFECYCLE_LANE_CONTRACT } from "./rule-lifecycle-contract.js";
 const RULE_LIFECYCLE_LANE = RULE_LIFECYCLE_LANE_CONTRACT.lane;
 const RULE_LIFECYCLE_TOOLS = RULE_LIFECYCLE_LANE_CONTRACT.tools;
+function lifecycleRollbackSpec(toolName) {
+    return {
+        target: (args) => `rule:${String(args.schemaCode ?? "")}/${String(args.ruleCode ?? "")}`,
+        read: async (session, args) => {
+            const rows = wireRows((await wireCall(session, { path: ENDPOINTS.businessRuleListBySchemaCode, query: { schemaCode: String(args.schemaCode) } })).data);
+            const row = rows.find((item) => String(item.code) === String(args.ruleCode));
+            if (!row)
+                return null;
+            if (toolName !== "rule.delete")
+                return { enabled: row.enabled, status: row.status };
+            return row.id ? (await wireCall(session, { path: ENDPOINTS.businessRuleGet, query: { id: String(row.id) } })).data : row;
+        },
+        inverse: ({ before, args }) => {
+            const base = { schemaCode: String(args.schemaCode), ruleCode: String(args.ruleCode) };
+            if (before == null)
+                return { kind: "calls", calls: [] };
+            if (toolName === "rule.enable")
+                return { kind: "calls", calls: [{ tool: "rule.disable", args: base }] };
+            if (toolName === "rule.disable")
+                return { kind: "calls", calls: [{ tool: "rule.enable", args: base }] };
+            const row = before;
+            return { kind: "calls", calls: [{ tool: "rule.save", args: { ...base, name: String(row.name ?? args.ruleCode), nodeGraph: { nodes: row.node, routes: row.route, schedulerSetting: row.schedulerSetting } } }], notes: ["删除后重建的规则 id/版本不保证一致"] };
+        },
+    };
+}
 export async function executeRuleEnableWrite(session, args) {
     await assertRuleSchemaExists(session, args.schemaCode);
     const list = await wireCall(session, { path: ENDPOINTS.businessRuleListBySchemaCode, query: { schemaCode: args.schemaCode } });
@@ -47,7 +72,7 @@ export async function executeRuleEnableWrite(session, args) {
     return { performed: { errcode: published.errcode, enableErrcode, ...(alreadyEnabled ? { alreadyEnabled: true } : {}) }, readback: { enabled: true } };
 }
 export function registerRuleLifecycleLane(tools) {
-    writeTool(tools, "rule.enable", RULE_LIFECYCLE_LANE, RULE_LIFECYCLE_TOOLS["rule.enable"].scope, RULE_LIFECYCLE_TOOLS["rule.enable"].description, { schemaCode: z.string().min(1), ruleCode: z.string().min(1) }, async (session, args) => executeRuleEnableWrite(session, args));
+    writeTool(tools, "rule.enable", RULE_LIFECYCLE_LANE, RULE_LIFECYCLE_TOOLS["rule.enable"].scope, RULE_LIFECYCLE_TOOLS["rule.enable"].description, { schemaCode: z.string().min(1), ruleCode: z.string().min(1) }, async (session, args) => executeRuleEnableWrite(session, args), undefined, undefined, lifecycleRollbackSpec("rule.enable"));
     writeTool(tools, "rule.disable", RULE_LIFECYCLE_LANE, RULE_LIFECYCLE_TOOLS["rule.disable"].scope, RULE_LIFECYCLE_TOOLS["rule.disable"].description, { schemaCode: z.string().min(1), ruleCode: z.string().min(1) }, async (session, args) => {
         await assertRuleSchemaExists(session, args.schemaCode);
         const list = await wireCall(session, { path: ENDPOINTS.businessRuleListBySchemaCode, query: { schemaCode: args.schemaCode } });
@@ -58,7 +83,7 @@ export function registerRuleLifecycleLane(tools) {
         const readback = await wireCall(session, { path: ENDPOINTS.businessRuleListBySchemaCode, query: { schemaCode: args.schemaCode } });
         const after = wireRows(readback.data).find((item) => item.code === args.ruleCode);
         return { performed: { errcode: performed.errcode }, readback: { enabled: after?.enabled === true } };
-    });
+    }, undefined, undefined, lifecycleRollbackSpec("rule.disable"));
     writeTool(tools, "rule.delete", RULE_LIFECYCLE_LANE, RULE_LIFECYCLE_TOOLS["rule.delete"].scope, RULE_LIFECYCLE_TOOLS["rule.delete"].description, { schemaCode: z.string().min(1), ruleCode: z.string().min(1) }, async (session, args) => {
         // Ticket 96 finding: the preset rule codes are platform-managed —
         // listViewsBySchemaCode re-fills any missing preset for the schema, so
@@ -78,7 +103,7 @@ export function registerRuleLifecycleLane(tools) {
         const performed = await wireCall(session, { path: ENDPOINTS.businessRuleDelete, method: "POST", query: { id: String(row.id) } });
         const readback = await wireCall(session, { path: ENDPOINTS.businessRuleListBySchemaCode, query: { schemaCode: args.schemaCode } });
         return { performed: { errcode: performed.errcode }, readback: { absent: !wireRows(readback.data).some((item) => item.code === args.ruleCode) } };
-    });
+    }, undefined, undefined, lifecycleRollbackSpec("rule.delete"));
     // Round 10 issue 05 — lifecycle batch. Disabling a model's rules one by one was
     // N calls; this flips `enabled:false` on every matching rule in one tool. Only
     // CUSTOM rules by default (platform preset trigger rows must not be disabled —

package/dist/lanes/workflow-contract.js

@@ -120,7 +120,7 @@ export const WORKFLOW_LANE_CONTRACT = Object.freeze({
         }),
         "workflow.update": Object.freeze({
             scope: WORKFLOW_SCOPE,
-            description: "写入工作流模板草稿（`/api/api/workflow/update`，raw template JSON body）。cli 以当前草稿为基线做 merge，未列出的既有节点保留：**模板缺 START 或 END 时自动按增量 merge（部分模板），给全 START..END 才整模板替换**；也可显式 `merge:true/false`。**节点字段权限也走这里**：不必读 `get_draft --full`——直接发 `activities:[{activityCode, activityType:\"PARTICIPANT\", propertyPermissions:[{propertyCode, visible, editable, required, summary, subPropertyPermissions}]}]`，工具按 propertyCode 合并到草稿对应节点（未列的字段权限保留；`merge:true` 也可同用）——没有单独的权限工具，别把「找不到入口」当成不支持（dogfood 实测该误判会假阻塞）。`summary` **无需配置**：工具合并时自动补 `summary:true`（平台怪癖——缺省进不了运行时 `activitySummaries`、`form/load` 读不到你的 `editable:false`；显式传 `false` 才保留）；子表字段用 `subPropertyPermissions`（同样自动补）。用 `npm run test:live-permission`（非管理员参与者）验收，管理员会被后端强制 `e:true` 掩盖。",
+            description: "写入工作流模板草稿（`/api/api/workflow/update`，raw template JSON body）。cli 以当前草稿为基线做 merge，未列出的既有节点保留：**模板缺 START 或 END 时自动按增量 merge（部分模板），给全 START..END 才整模板替换**；也可显式 `merge:true/false`。**节点字段权限也走这里**：不必读 `get_draft --full`——直接发 `activities:[{activityCode, propertyPermissions:[{propertyCode, visible, editable, required, summary, subPropertyPermissions}]}]`（**type 可省**：activityCode 命中草稿节点时类型/名称继承草稿，不会铸 `_2` 新码；改名才产生新码——平台不能原地改名），工具按 propertyCode 合并到草稿对应节点（未列的字段权限保留；`merge:true` 也可同用）——没有单独的权限工具，别把「找不到入口」当成不支持（dogfood 实测该误判会假阻塞）。`summary` **无需配置**：工具合并时自动补 `summary:true`（平台怪癖——缺省进不了运行时 `activitySummaries`、`form/load` 读不到你的 `editable:false`；显式传 `false` 才保留）；子表字段用 `subPropertyPermissions`（同样自动补）。**子表属性不可设 `required:true`**（接口形状接受但设计器节点字段配置不支持，存入后无法渲染——工具直接拒 `workflow-child-table-not-required`）；子表整行只配 visible/editable，字段级必填配到子表内部字段所在节点。**新增节点用语义 code**（如 `approval_finance`），不要模仿草稿的 `ActivityN` 再加 `_1/_2` 后缀。**设计器默认自动补齐**（调用方显式传值优先）：填写节点（{Originator}）自动生成子表操作按钮 `buttonPermission.childTableBtns`（每个子表 ADD/DELETE/IMPORT/EXPORT 启用、BATCH_UPDATE 禁用——API 建的流程缺这份模板，设计器里子表按钮会全部不勾）；`permittedAction` 归一为设计器默认（填写节点 showReject:false 不能驳回自己，审批节点 rejectToStart:true 驳回回发起节点）。用 `npm run test:live-permission`（非管理员参与者）验收，管理员会被后端强制 `e:true` 掩盖。",
         }),
         "workflow.publish": Object.freeze({
             scope: WORKFLOW_SCOPE,