@stalfh233/omc-cli 0.6.7 → 0.6.11

package/dist/lanes/businessrule.js

@@ -9,6 +9,7 @@ import { executeRuleSaveWrite, ruleNodeGraphArg } from "../rule-support.js";
 import { defineTool, ToolInputError, ToolRefusalError } from "../tool-types.js";
 import { resolveRuleRowId } from "../identity.js";
 import { wireCall, wireCallWith404Fallback, wireRows } from "../wire.js";
+import { readModelRecord } from "../model-record.js";
 import { BUSINESSRULE_LANE_CONTRACT } from "./businessrule-contract.js";
 const RULE_LANE = BUSINESSRULE_LANE_CONTRACT.lane;
 const RULE_TOOLS = BUSINESSRULE_LANE_CONTRACT.tools;
@@ -109,6 +110,20 @@ export function registerBusinessRuleLane(tools) {
             capability: capabilityArg,
         },
         handler: async (ctx, args, self) => governedRead(ctx, self, args, async (session) => {
+            // r28g F35/F36：list_by_schemacode 对任意 schemaCode 会补建 7 条预置并
+            // publish。从未存在的模型一旦被 list，就留下 API 删不掉的预置行。
+            // 写前 gate（assertRuleSchemaExists）已拦；读面也必须先探，不存在则
+            // 直接回 modelPresent:false + rules:[]，**不发 list 请求**。
+            const modelRecord = await readModelRecord(session, args.schemaCode);
+            if (modelRecord === null) {
+                return {
+                    schemaCode: args.schemaCode,
+                    modelPresent: false,
+                    rules: [],
+                    rulesCount: 0,
+                    hint: "模型不存在（bizmodels/get_all 空）——未发 rule.list 请求（避免补建 7 条不可删预置）；判定模型面用 model.inspect",
+                };
+            }
             // 版本族备选（2026-11-03 issue A1）：8.6 锚点走 runtime 面；8.1 族
             // runtime 端点缺席（404）时下探 app 面 `businessrule/list_by_schemacode`。
             // 仅 404 下探，401/500/业务码拒绝原样上抛。rule.save / rule.enable 的
@@ -126,23 +141,14 @@ export function registerBusinessRuleLane(tools) {
             // key (schemaCode+ruleCode), so the row id is rarely needed.
             const fullRows = args.full === true;
             const visible = args.onlyCustom === true ? rows.filter((row) => row.defaultRule !== true) : rows;
-            // r40 维护者自踩：schemaCode 不存在时平台静默回空数组——空规则被读成
-            // 『模型在、无规则』走错分支（mcc_contract 从不存在却答 0 规则）。
-            // 空结果时用 field.list 探一次真身（300004=不存在），把 modelPresent 标进结果。
-            let modelPresent = true;
-            if (visible.length === 0) {
-                try {
-                    await wireCall(session, { path: ENDPOINTS.fieldList, query: { schemaCode: args.schemaCode, isPublish: "true" } });
-                }
-                catch (error) {
-                    if (String(error.message ?? error).includes("errcode 300004"))
-                        modelPresent = false;
-                }
-            }
             return {
                 schemaCode: args.schemaCode,
-                ...(modelPresent ? {} : { modelPresent: false, hint: "模型不存在（field.list 300004）——空规则是假象；先 model.create / configure_model，判定模型面用 model.inspect" }),
+                modelPresent: true,
+                // r28g F18：list 投影的是 PUBLISH 行；运行时可执行性以 rule.get / rule.enable.verified 为准。
+                source: "published-list",
+                executableHint: "rules[].enabled/status 来自 PUBLISH 投影；运行时判定读 DRAFT（rule.get 的 enabled+ruleStatus，或 rule.enable 回执的 executable/verified）。不要仅凭本面判定可 rule.run。",
                 ...(args.onlyCustom === true ? { filtered: { onlyCustom: true, total: rows.length, returned: visible.length } } : {}),
+                ...(endpointFamily ? { endpointFamily } : {}),
                 rules: visible.map((row) => ({
                     code: row.code,
                     name: row.name,
@@ -439,48 +445,66 @@ export function registerBusinessRuleLane(tools) {
             return payload;
         }, { full: args.full === true, compact: ruleCompactProjection, target: `rule.get:${args.id ?? `${args.schemaCode}/${args.ruleCode}`}` }),
     }));
-    writeTool(tools, "rule.save", RULE_LANE, RULE_TOOLS["rule.save"].scope, RULE_TOOLS["rule.save"].description, {
-        schemaCode: z.string().min(1),
-        ruleCode: z.string().min(1),
-        name: z.string().min(1),
-        nodeGraph: ruleNodeGraphArg,
-        publish: z.boolean().optional().describe("also publish the new version in this call (businessrule/publish) so the designer sees it; enabling stays with rule.enable — default false keeps the legacy draft-only save"),
-        customTrigger: z.boolean().optional().describe("默认开：自定义 ruleCode + bizRuleType 0（非平台触发码 Create/Update/Delete/GetList/Load/Available/Cancel）即按钮/流程规则，工具在 START 后合成平台标准 CUSTOM_NODE「自定义按钮/流程触发」系统触发节点（nodeCode=ruleCode，live 布局 x558/y233）；调用方已写 CUSTOM_NODE 则原样保留；显式 false 退回"),
-    }, async (session, args) => executeRuleSaveWrite(session, args), undefined, undefined, businessRuleRollbackSpec("rule.save"));
+    writeTool({
+        tools,
+        name: "rule.save",
+        lane: RULE_LANE,
+        scope: RULE_TOOLS["rule.save"].scope,
+        description: RULE_TOOLS["rule.save"].description,
+        inputSchema: {
+            schemaCode: z.string().min(1),
+            ruleCode: z.string().min(1),
+            name: z.string().min(1),
+            nodeGraph: ruleNodeGraphArg,
+            publish: z.boolean().optional().describe("also publish the new version in this call (businessrule/publish) so the designer sees it; enabling stays with rule.enable — default false keeps the legacy draft-only save"),
+            customTrigger: z.boolean().optional().describe("默认开：自定义 ruleCode + bizRuleType 0（非平台触发码 Create/Update/Delete/GetList/Load/Available/Cancel）即按钮/流程规则，工具在 START 后合成平台标准 CUSTOM_NODE「自定义按钮/流程触发」系统触发节点（nodeCode=ruleCode，live 布局 x558/y233）；调用方已写 CUSTOM_NODE 则原样保留；显式 false 退回"),
+        },
+        execute: async (session, args) => executeRuleSaveWrite(session, args),
+        rollback: businessRuleRollbackSpec("rule.save"),
+    });
     // Round 10 (issue 04) — precise modify. `rule.save` replaces the WHOLE nodeGraph,
     // so changing one branch threshold meant read the whole graph, edit, resend. This
     // tool reads the current graph, patches ONE node, and reuses the same save seam
     // (so every graph gate + readback is identical). Platform constraints honoured:
     // `nodeCode`/`nodeType` are immutable (routes reference nodeCode; the platform
     // cannot retype a node), so the patch may not change them.
-    writeTool(tools, "rule.node.update", RULE_LANE, RULE_TOOLS["rule.node.update"].scope, RULE_TOOLS["rule.node.update"].description, {
-        schemaCode: z.string().min(1),
-        ruleCode: z.string().min(1),
-        nodeCode: z.string().min(1).describe("要改的节点 nodeCode（在现有图里定位，不是新建）"),
-        patch: z.record(z.string(), z.unknown()).describe("浅合并到该节点的字段（如 exitConditionGroups/filterCondition/dataActions/nodeName）；不允许改 nodeCode/nodeType"),
-        publish: z.boolean().optional().describe("改完同样顺带 publish（默认 false，仅存草稿；生效仍需 rule.enable）"),
-        customTrigger: z.boolean().optional(),
-    }, async (session, args) => {
-        const id = await resolveRuleRowId(session, args.schemaCode, args.ruleCode);
-        if (!id)
-            throw new ToolRefusalError({ status: "refused", blocker: "rule-absent", message: `规则 ${args.schemaCode}.${args.ruleCode} 不存在；拒绝 node patch` });
-        const record = (await wireCall(session, { path: ENDPOINTS.businessRuleGet, query: { id } })).data;
-        if (!record)
-            throw new ToolRefusalError({ status: "refused", blocker: "rule-absent", message: `规则 ${args.schemaCode}.${args.ruleCode}（id ${id}）读回为空` });
-        for (const key of ["nodeCode", "nodeType"])
-            if (key in args.patch)
-                throw new ToolRefusalError({ status: "refused", blocker: "rule-node-immutable-key", message: `node patch 不允许改 ${key}（平台按 nodeCode 连接路由、节点类型不可变）；要改名/改型请整图 rule.save` });
-        // node/route are SEPARATE JSON-string columns (see rule.get): `node` is the
-        // nodes array, `route` the routes array — not one {nodes,routes} object.
-        const nodes = decodeJsonColumn(record.node, JSON_COLUMN_NULL_COALESCE);
-        const routes = decodeJsonColumn(record.route, JSON_COLUMN_NULL_COALESCE);
-        const nodeList = Array.isArray(nodes) ? nodes : [];
-        const target = nodeList.find((node) => node.nodeCode === args.nodeCode);
-        if (!target)
-            throw new ToolRefusalError({ status: "refused", blocker: "rule-node-absent", message: `现有图中没有 nodeCode=${args.nodeCode}；用 rule.get schemaCode+ruleCode 查看 nodeCode` });
-        const mergedNode = { ...target, ...args.patch };
-        const mergedGraph = { nodes: nodeList.map((node) => (node.nodeCode === args.nodeCode ? mergedNode : node)), ...(Array.isArray(routes) ? { routes } : {}) };
-        return executeRuleSaveWrite(session, { schemaCode: args.schemaCode, ruleCode: args.ruleCode, name: String(record.name ?? args.ruleCode), nodeGraph: mergedGraph, ...(args.publish === true ? { publish: true } : {}), ...(args.customTrigger === true ? { customTrigger: true } : {}) });
-    }, undefined, undefined, businessRuleRollbackSpec("rule.node.update"));
+    writeTool({
+        tools,
+        name: "rule.node.update",
+        lane: RULE_LANE,
+        scope: RULE_TOOLS["rule.node.update"].scope,
+        description: RULE_TOOLS["rule.node.update"].description,
+        inputSchema: {
+            schemaCode: z.string().min(1),
+            ruleCode: z.string().min(1),
+            nodeCode: z.string().min(1).describe("要改的节点 nodeCode（在现有图里定位，不是新建）"),
+            patch: z.record(z.string(), z.unknown()).describe("浅合并到该节点的字段（如 exitConditionGroups/filterCondition/dataActions/nodeName）；不允许改 nodeCode/nodeType"),
+            publish: z.boolean().optional().describe("改完同样顺带 publish（默认 false，仅存草稿；生效仍需 rule.enable）"),
+            customTrigger: z.boolean().optional(),
+        },
+        execute: async (session, args) => {
+            const id = await resolveRuleRowId(session, args.schemaCode, args.ruleCode);
+            if (!id)
+                throw new ToolRefusalError({ status: "refused", blocker: "rule-absent", message: `规则 ${args.schemaCode}.${args.ruleCode} 不存在；拒绝 node patch` });
+            const record = (await wireCall(session, { path: ENDPOINTS.businessRuleGet, query: { id } })).data;
+            if (!record)
+                throw new ToolRefusalError({ status: "refused", blocker: "rule-absent", message: `规则 ${args.schemaCode}.${args.ruleCode}（id ${id}）读回为空` });
+            for (const key of ["nodeCode", "nodeType"])
+                if (key in args.patch)
+                    throw new ToolRefusalError({ status: "refused", blocker: "rule-node-immutable-key", message: `node patch 不允许改 ${key}（平台按 nodeCode 连接路由、节点类型不可变）；要改名/改型请整图 rule.save` });
+            // node/route are SEPARATE JSON-string columns (see rule.get): `node` is the
+            // nodes array, `route` the routes array — not one {nodes,routes} object.
+            const nodes = decodeJsonColumn(record.node, JSON_COLUMN_NULL_COALESCE);
+            const routes = decodeJsonColumn(record.route, JSON_COLUMN_NULL_COALESCE);
+            const nodeList = Array.isArray(nodes) ? nodes : [];
+            const target = nodeList.find((node) => node.nodeCode === args.nodeCode);
+            if (!target)
+                throw new ToolRefusalError({ status: "refused", blocker: "rule-node-absent", message: `现有图中没有 nodeCode=${args.nodeCode}；用 rule.get schemaCode+ruleCode 查看 nodeCode` });
+            const mergedNode = { ...target, ...args.patch };
+            const mergedGraph = { nodes: nodeList.map((node) => (node.nodeCode === args.nodeCode ? mergedNode : node)), ...(Array.isArray(routes) ? { routes } : {}) };
+            return executeRuleSaveWrite(session, { schemaCode: args.schemaCode, ruleCode: args.ruleCode, name: String(record.name ?? args.ruleCode), nodeGraph: mergedGraph, ...(args.publish === true ? { publish: true } : {}), ...(args.customTrigger === true ? { customTrigger: true } : {}) });
+        },
+        rollback: businessRuleRollbackSpec("rule.node.update"),
+    });
 }
 //# sourceMappingURL=businessrule.js.map

package/dist/lanes/custom-page.js

@@ -127,63 +127,90 @@ export function registerCustomPageTools(tools) {
             };
         }),
     }));
-    writeTool(tools, "custompage.create", LANE, T["custompage.create"].scope, T["custompage.create"].description, {
-        name: z.string().min(1),
-        code: z.string().min(1).describe("页面 code（≤28 字符，平台 validateCode28）"),
-        parentId: z.string().min(1).describe("父节点 id（应用根或目录）；用 folder.tree 取"),
-        applicationCode: z.string().optional().describe("应用 code；省略用配置/默认应用"),
-        menuPointType: z.enum(MENU_POINT_TYPES).optional().describe("菜单类型；自定义页固定 CUSTOM_PAGE（省略即用 CUSTOM_PAGE）"),
-        icon: z.string().optional(),
-        pcAble: z.boolean().optional().describe("PC 端可见（默认 true）"),
-        mobileAble: z.boolean().optional().describe("移动端可见（默认 true）"),
-        openMode: z.string().optional().describe("打开方式；默认 VUE_MODE（平台建 CustomPageModel 时也用这个）"),
-    }, async (session, args) => {
-        const appCode = await resolveApplicationCode(session, args.applicationCode);
-        const body = {
-            name: args.name,
-            name_i18n: JSON.stringify({ zh: args.name }),
-            code: args.code,
-            parentId: args.parentId,
-            appCode,
-            menuPointType: args.menuPointType ?? "CUSTOM_PAGE",
-            pcAble: args.pcAble !== false,
-            mobileAble: args.mobileAble !== false,
-            openMode: args.openMode ?? "VUE_MODE",
-            ...(args.icon !== undefined ? { icon: args.icon } : {}),
-        };
-        const performed = await wireCall(session, { path: ENDPOINTS.customPageCreate, method: "POST", body });
-        const readback = await readPageOrNull(session, args.code);
-        return {
-            performed: { errcode: performed.errcode },
-            readback: { code: args.code, present: readback !== null, page: readback ? pickPage(readback) : null, next: `写入页面正文：omc call custompage.content.update --args '{"code":"${args.code}","content":"<JS/HTML>"}'` },
-        };
+    writeTool({
+        tools,
+        name: "custompage.create",
+        lane: LANE,
+        scope: T["custompage.create"].scope,
+        description: T["custompage.create"].description,
+        inputSchema: {
+            name: z.string().min(1),
+            code: z.string().min(1).describe("页面 code（≤28 字符，平台 validateCode28）"),
+            parentId: z.string().min(1).describe("父节点 id（应用根或目录）；用 folder.tree 取。平台 create/get 都不回迁移后的 parentId——create 回执会给 parentIdNote，请用 folder.tree 按 code 核对落点"),
+            applicationCode: z.string().optional().describe("应用 code；省略用配置/默认应用"),
+            menuPointType: z.enum(MENU_POINT_TYPES).optional().describe("菜单类型；自定义页固定 CUSTOM_PAGE（省略即用 CUSTOM_PAGE）"),
+            icon: z.string().optional(),
+            pcAble: z.boolean().optional().describe("PC 端可见（默认 true）"),
+            mobileAble: z.boolean().optional().describe("移动端可见（默认 true）"),
+            openMode: z.string().optional().describe("打开方式；默认 VUE_MODE（平台建 CustomPageModel 时也用这个）"),
+        },
+        execute: async (session, args) => {
+            const appCode = await resolveApplicationCode(session, args.applicationCode);
+            const body = {
+                name: args.name,
+                name_i18n: JSON.stringify({ zh: args.name }),
+                code: args.code,
+                parentId: args.parentId,
+                appCode,
+                menuPointType: args.menuPointType ?? "CUSTOM_PAGE",
+                pcAble: args.pcAble !== false,
+                mobileAble: args.mobileAble !== false,
+                openMode: args.openMode ?? "VUE_MODE",
+                ...(args.icon !== undefined ? { icon: args.icon } : {}),
+            };
+            const performed = await wireCall(session, { path: ENDPOINTS.customPageCreate, method: "POST", body });
+            const readback = await readPageOrNull(session, args.code);
+            const page = readback ? pickPage(readback) : null;
+            // r28i F5/F6: /custom/get does not return the AppFunction parentId. Leaving
+            // page.parentId:null on create looked like "hung at root / failed to attach".
+            const parentIdNote = "平台 create/get 不回迁移后的 parentId（它属于应用树 AppFunction 行）；null 不代表没挂上。用 custompage.get 或 folder.tree 按 code 核对实际落点；要改父节点请 custompage.update 显式传 parentId";
+            return {
+                performed: { errcode: performed.errcode },
+                readback: {
+                    code: args.code,
+                    present: readback !== null,
+                    page,
+                    parentIdNote,
+                    requestedParentId: args.parentId,
+                    next: `写入页面正文：omc call custompage.content.update --args '{"code":"${args.code}","content":"<JS/HTML>"}'；父节点请用 folder.tree 按 code 校验`,
+                },
+            };
+        },
     });
-    writeTool(tools, "custompage.update", LANE, T["custompage.update"].scope, T["custompage.update"].description, {
-        name: z.string().optional(),
-        code: z.string().min(1),
-        parentId: z.string().min(1).describe("父节点 id（平台 update 强制必填，省略会 50000）"),
-        menuPointType: z.enum(MENU_POINT_TYPES).optional(),
-        icon: z.string().optional(),
-        pcAble: z.boolean().optional(),
-        mobileAble: z.boolean().optional(),
-        openMode: z.string().optional(),
-    }, async (session, args) => {
-        const current = await readPageOrNull(session, args.code);
-        if (current === null)
-            throw new ToolRefusalError({ status: "refused", blocker: "custompage-absent", code: args.code, message: `自定义页 ${args.code} 不存在；先 custompage.create` });
-        const body = {
-            ...current,
-            name: args.name ?? current.name,
-            parentId: args.parentId,
-            menuPointType: args.menuPointType ?? current.menuPointType ?? "CUSTOM_PAGE",
-            pcAble: args.pcAble ?? current.pcAble ?? true,
-            mobileAble: args.mobileAble ?? current.mobileAble ?? true,
-            ...(args.openMode !== undefined ? { openMode: args.openMode } : {}),
-            ...(args.icon !== undefined ? { icon: args.icon } : {}),
-        };
-        const performed = await wireCall(session, { path: ENDPOINTS.customPageUpdate, method: "POST", body });
-        const readback = await readPageOrNull(session, args.code);
-        return { performed: { errcode: performed.errcode }, readback: { code: args.code, page: readback ? pickPage(readback) : null } };
+    writeTool({
+        tools,
+        name: "custompage.update",
+        lane: LANE,
+        scope: T["custompage.update"].scope,
+        description: T["custompage.update"].description,
+        inputSchema: {
+            name: z.string().optional(),
+            code: z.string().min(1),
+            parentId: z.string().min(1).describe("父节点 id（平台 update 强制必填，省略会 50000）"),
+            menuPointType: z.enum(MENU_POINT_TYPES).optional(),
+            icon: z.string().optional(),
+            pcAble: z.boolean().optional(),
+            mobileAble: z.boolean().optional(),
+            openMode: z.string().optional(),
+        },
+        execute: async (session, args) => {
+            const current = await readPageOrNull(session, args.code);
+            if (current === null)
+                throw new ToolRefusalError({ status: "refused", blocker: "custompage-absent", code: args.code, message: `自定义页 ${args.code} 不存在；先 custompage.create` });
+            const body = {
+                ...current,
+                name: args.name ?? current.name,
+                parentId: args.parentId,
+                menuPointType: args.menuPointType ?? current.menuPointType ?? "CUSTOM_PAGE",
+                pcAble: args.pcAble ?? current.pcAble ?? true,
+                mobileAble: args.mobileAble ?? current.mobileAble ?? true,
+                ...(args.openMode !== undefined ? { openMode: args.openMode } : {}),
+                ...(args.icon !== undefined ? { icon: args.icon } : {}),
+            };
+            const performed = await wireCall(session, { path: ENDPOINTS.customPageUpdate, method: "POST", body });
+            const readback = await readPageOrNull(session, args.code);
+            return { performed: { errcode: performed.errcode }, readback: { code: args.code, page: readback ? pickPage(readback) : null } };
+        },
     });
     tools.push(defineTool({
         name: "custompage.content.get",
@@ -218,70 +245,94 @@ export function registerCustomPageTools(tools) {
             };
         }),
     }));
-    writeTool(tools, "custompage.content.update", LANE, T["custompage.content.update"].scope, T["custompage.content.update"].description, {
-        code: z.string().min(1),
-        content: z.string().describe("页面正文（JS/HTML）。大体积请用 --args-file 传整个 args 对象，避免命令行引号/长度限制"),
-        publish: z.boolean().optional().describe("true = 同一调用里再走 /page/content/publish（草稿 + 发布都写），默认 false 只存草稿"),
-    }, async (session, args) => {
-        const performed = await wireCall(session, {
-            path: ENDPOINTS.customPageContentUpdate,
-            method: "POST",
-            body: { code: args.code, draftContent: args.content, publishedContent: args.content },
-        });
-        let publishErrcode = null;
-        if (args.publish === true) {
-            const published = await wireCall(session, {
-                path: ENDPOINTS.customPageContentPublish,
+    writeTool({
+        tools,
+        name: "custompage.content.update",
+        lane: LANE,
+        scope: T["custompage.content.update"].scope,
+        description: T["custompage.content.update"].description,
+        inputSchema: {
+            code: z.string().min(1),
+            content: z.string().describe("页面正文（JS/HTML）。大体积请用 --args-file 传整个 args 对象（路径必须在配置根 OMC_CONFIG_HOME/默认 cwd 内；临时文件请放 ./.scratch/），或用 --args - 从 stdin 读，避免命令行引号/长度限制"),
+            publish: z.boolean().optional().describe("true = 同一调用里再走 /page/content/publish（草稿 + 发布都写），默认 false 只存草稿"),
+        },
+        execute: async (session, args) => {
+            const performed = await wireCall(session, {
+                path: ENDPOINTS.customPageContentUpdate,
                 method: "POST",
                 body: { code: args.code, draftContent: args.content, publishedContent: args.content },
             });
-            publishErrcode = published.errcode;
-        }
-        const readback = (await wireCall(session, { path: ENDPOINTS.customPageContentGet, query: { code: args.code } })).data;
-        const draft = typeof readback?.draftContent === "string" ? readback.draftContent : null;
-        const publishedContent = typeof readback?.publishedContent === "string" ? readback.publishedContent : null;
-        return {
-            performed: { errcode: performed.errcode, ...(publishErrcode === null ? {} : { publishErrcode }) },
-            readback: {
-                code: args.code,
-                existDraft: readback?.existDraft ?? null,
-                published: readback?.published ?? null,
-                draftMatches: draft === args.content,
-                publishedMatches: publishedContent === args.content,
-                ...(publishErrcode === null ? { publishHint: "只写了草稿：门户读 publishedContent。要上线再 custompage.content.publish（或本工具 publish:true）" } : {}),
-            },
-        };
+            let publishErrcode = null;
+            if (args.publish === true) {
+                const published = await wireCall(session, {
+                    path: ENDPOINTS.customPageContentPublish,
+                    method: "POST",
+                    body: { code: args.code, draftContent: args.content, publishedContent: args.content },
+                });
+                publishErrcode = published.errcode;
+            }
+            const readback = (await wireCall(session, { path: ENDPOINTS.customPageContentGet, query: { code: args.code } })).data;
+            const draft = typeof readback?.draftContent === "string" ? readback.draftContent : null;
+            const publishedContent = typeof readback?.publishedContent === "string" ? readback.publishedContent : null;
+            return {
+                performed: { errcode: performed.errcode, ...(publishErrcode === null ? {} : { publishErrcode }) },
+                readback: {
+                    code: args.code,
+                    existDraft: readback?.existDraft ?? null,
+                    published: readback?.published ?? null,
+                    draftMatches: draft === args.content,
+                    publishedMatches: publishedContent === args.content,
+                    ...(publishErrcode === null ? { publishHint: "只写了草稿：门户读 publishedContent。要上线再 custompage.content.publish（或本工具 publish:true）" } : {}),
+                },
+            };
+        },
     });
-    writeTool(tools, "custompage.content.publish", LANE, T["custompage.content.publish"].scope, T["custompage.content.publish"].description, {
-        code: z.string().min(1),
-        content: z.string().optional().describe("要发布的正文；省略则把当前 draftContent 发布出去"),
-    }, async (session, args) => {
-        const current = (await wireCall(session, { path: ENDPOINTS.customPageContentGet, query: { code: args.code } })).data;
-        const draft = typeof current?.draftContent === "string" ? current.draftContent : null;
-        const content = args.content ?? draft;
-        if (content === null)
-            throw new ToolRefusalError({ status: "refused", blocker: "custompage-content-absent", code: args.code, message: `自定义页 ${args.code} 没有草稿正文，且本次未传 content；先 custompage.content.update` });
-        const performed = await wireCall(session, {
-            path: ENDPOINTS.customPageContentPublish,
-            method: "POST",
-            body: { code: args.code, draftContent: draft ?? content, publishedContent: content },
-        });
-        const readback = (await wireCall(session, { path: ENDPOINTS.customPageContentGet, query: { code: args.code } })).data;
-        const publishedContent = typeof readback?.publishedContent === "string" ? readback.publishedContent : null;
-        return {
-            performed: { errcode: performed.errcode },
-            readback: { code: args.code, published: readback?.published ?? null, publishedMatches: publishedContent === content, publishedBytes: publishedContent === null ? 0 : Buffer.byteLength(publishedContent, "utf8") },
-        };
+    writeTool({
+        tools,
+        name: "custompage.content.publish",
+        lane: LANE,
+        scope: T["custompage.content.publish"].scope,
+        description: T["custompage.content.publish"].description,
+        inputSchema: {
+            code: z.string().min(1),
+            content: z.string().optional().describe("要发布的正文；省略则把当前 draftContent 发布出去"),
+        },
+        execute: async (session, args) => {
+            const current = (await wireCall(session, { path: ENDPOINTS.customPageContentGet, query: { code: args.code } })).data;
+            const draft = typeof current?.draftContent === "string" ? current.draftContent : null;
+            const content = args.content ?? draft;
+            if (content === null)
+                throw new ToolRefusalError({ status: "refused", blocker: "custompage-content-absent", code: args.code, message: `自定义页 ${args.code} 没有草稿正文，且本次未传 content；先 custompage.content.update` });
+            const performed = await wireCall(session, {
+                path: ENDPOINTS.customPageContentPublish,
+                method: "POST",
+                body: { code: args.code, draftContent: draft ?? content, publishedContent: content },
+            });
+            const readback = (await wireCall(session, { path: ENDPOINTS.customPageContentGet, query: { code: args.code } })).data;
+            const publishedContent = typeof readback?.publishedContent === "string" ? readback.publishedContent : null;
+            return {
+                performed: { errcode: performed.errcode },
+                readback: { code: args.code, published: readback?.published ?? null, publishedMatches: publishedContent === content, publishedBytes: publishedContent === null ? 0 : Buffer.byteLength(publishedContent, "utf8") },
+            };
+        },
     });
-    writeTool(tools, "custompage.delete", LANE, T["custompage.delete"].scope, T["custompage.delete"].description, {
-        code: z.string().min(1),
-    }, async (session, args) => {
-        const current = await readPageOrNull(session, args.code);
-        if (current === null)
-            return { performed: { skipped: "already-absent" }, readback: { code: args.code, absent: true } };
-        const performed = await wireCall(session, { path: ENDPOINTS.customPageDelete, query: { code: args.code } });
-        const readback = await readPageOrNull(session, args.code);
-        return { performed: { errcode: performed.errcode }, readback: { code: args.code, absent: readback === null } };
+    writeTool({
+        tools,
+        name: "custompage.delete",
+        lane: LANE,
+        scope: T["custompage.delete"].scope,
+        description: T["custompage.delete"].description,
+        inputSchema: {
+            code: z.string().min(1),
+        },
+        execute: async (session, args) => {
+            const current = await readPageOrNull(session, args.code);
+            if (current === null)
+                return { performed: { skipped: "already-absent" }, readback: { code: args.code, absent: true } };
+            const performed = await wireCall(session, { path: ENDPOINTS.customPageDelete, query: { code: args.code } });
+            const readback = await readPageOrNull(session, args.code);
+            return { performed: { errcode: performed.errcode }, readback: { code: args.code, absent: readback === null } };
+        },
     });
 }
 //# sourceMappingURL=custom-page.js.map

package/dist/lanes/datarule-contract.js

@@ -83,8 +83,8 @@ export const DATARULE_LANE_CONTRACT = Object.freeze({
         }),
         "datarule.create": Object.freeze({
             scope: DATARULE_SCOPE,
-            description: describeTool("Create a field-level data rule (bizdatarule/create) and read it back from the authoritative list.", [
-                "`dataRuleType`: 1 校验 / 2 计算拼接 / 3 显示 / 4 必填 / 5 只读 (8 EXTENSION is out of scope).",
+            description: describeTool("Create a field-level data rule (bizdatarule/create) and read it back from the authoritative list. **表单运行时条件优先 `field.update`**（本工具=字段级引擎/设计器读面）。", [
+                "`dataRuleType` → options 键：1→conditions/prompt/regexp/maxLength（+checkType）；2→shortTextStitch|expression；3→displayFormula；4→requiredFormula（无条件必填=`\"true\"`）；5→readonlyCondition。8 EXTENSION out of scope.",
                 "**⚠️ type3/4/5 行的两个读面**：门户**运行时**读**字段 options**（`requiredFormula`/`readonlyCondition`/`readonlyFormula`/`displayFormula`，`field.create/update` 写）；表单设计器**设计态** Set/Unset 读 **bizdatarule/list**（本行，network capture 2026-09-23）。**实测：type3/4/5 规则单独不会让门户表单控件变必填/只读**（中文或符号操作符都一样），符号式经 `historyOpt` 镜像还会让表单渲染崩溃——运行时条件请用中文操作符。表单条件优先走 `field.update`：它会**自动配对**本行（readback.formConditionSync）。本工具用于字段级引擎规则或独立增删改。",
                 "**类型3/4/5 条件串协议（平台 create 不校验，坏形状落库即雷，工具按此协议拒绝）**：`{字段code} 操作符 [值]`。操作符取 **bizdatarule 词表**（与字段 options 的表单交互引擎不同——那是符号式）：**中文** 等于/不等于/大于/小于/大于等于/小于等于/包含/不包含/包含全部/不包含全部/包含任意一个/不包含任意一个/等于任意一个/属于/不属于/介于/为空/不为空（实测 146 条真实规则以此为主），也接受符号 `==` `!=` `>` `<` `>=` `<=` `Contains` `IsEmpty` 等。为空/不为空**不带值**（`{field} 不为空`）；其余带值（JSON 对象或标量）。多条件 ` && `、多组 ` || `。示例 type4：`options:{requiredFormula:\"{amount} 等于 {\\\"valueType\\\":\\\"specifyOption\\\",\\\"value\\\":\\\"A\\\"}\"}`；无条件必填用字面量 \"true\"。**字段绑定用 `propertyCodes`（数组）**，工具自动把 `options.propertyCodes` 也补上；存量的坏规则由 datarule.list 以 shapeWarning 标出。",
                 "`options` is a JSON object sent to the wire as a JSON string; the engine reads `requiredFormula` (4), `readonlyCondition` (5), `displayFormula` (3), `verifyFormula` (1) and `shortTextStitch` (2).",