@stalfh233/omc-cli 0.4.90 → 0.4.92

package/coverage/m1-coverage-manifest-v1.json

@@ -1366,6 +1366,43 @@
         "app-tree folder rename/move (folders/update)",
         "app-tree folder delete (folders/delete, non-recursive)"
       ]
+    },
+    {
+      "capability": "Custom pages (自定义页面): app-tree node + JS/HTML body (draft/publish)",
+      "status": "executable",
+      "scope": "Custom pages: app-tree node (AppFunction type=Page) create/update/delete/list plus the page body (CustomPageModel draftContent/publishedContent) read, draft write, and publish. Node-first is enforced because /page/content/* resolves the AppFunction by code.",
+      "version_family": "8.6",
+      "anchor_version": "8.6.26",
+      "evidence": [
+        {
+          "path": "cp-sources/backend/decompiled-full/launcher-8.6.26/cloudpivot-engine-8.6.26/com/authine/cloudpivot/web/api/controller/app/CustomPageController.java"
+        },
+        {
+          "path": "packages/omc-cli/src/lanes/custom-page.ts"
+        }
+      ],
+      "lane": "app-tree-folders",
+      "notes": "CustomPageController (@RequestMapping /api/custom): /create requires parentId and a non-null menuPointType (NPE→50000 otherwise) and forces type=Page; /page/content/update writes draftContent, /page/content/publish writes publishedContent, both require the AppFunction to exist (BIZ_SCHEMA_NOT_EXIST otherwise).",
+      "tools": [
+        "custompage.list",
+        "custompage.get",
+        "custompage.create",
+        "custompage.update",
+        "custompage.content.get",
+        "custompage.content.update",
+        "custompage.content.publish",
+        "custompage.delete"
+      ],
+      "scopes": [
+        "app-tree custom page list (custom/page/list_by_appcode)",
+        "app-tree custom page node (custom/get)",
+        "app-tree custom page create (custom/create, AppFunction type=Page + CustomPageModel)",
+        "app-tree custom page update (custom/update)",
+        "custom page body read (custom/page/content/get)",
+        "custom page body draft write (custom/page/content/update)",
+        "custom page body publish (custom/page/content/publish)",
+        "custom page delete (custom/delete)"
+      ]
     }
   ]
 }

package/dist/endpoints.js

@@ -33,6 +33,24 @@ export const ENDPOINTS = {
     folderGet: "/api/api/app/folders/get",
     folderUpdate: "/api/api/app/folders/update",
     folderDelete: "/api/api/app/folders/delete",
+    /**
+     * Custom pages (自定义页面) — decompiled 8.6.26 CustomPageController
+     * (`@RequestMapping("/api/custom")`). The app-tree node and the page body are
+     * TWO rows: `/create` makes the AppFunction node (type=Page) plus an empty
+     * CustomPageModel; `/page/content/update` writes draftContent/publishedContent
+     * onto that model and auto-creates it if absent (requires the AppFunction).
+     */
+    customPageCreate: "/api/api/custom/create",
+    customPageUpdate: "/api/api/custom/update",
+    customPageGet: "/api/api/custom/get",
+    /** `/custom/list?modeType=` returns every CustomPageModel row (the node face
+     * `/custom/page/list_by_appcode` filters NodeType.CustomPage and misses rows
+     * created by /custom/create, which forces NodeType.Page — live 1.1.25). */
+    customPageList: "/api/api/custom/list",
+    customPageDelete: "/api/api/custom/delete",
+    customPageContentGet: "/api/api/custom/page/content/get",
+    customPageContentUpdate: "/api/api/custom/page/content/update",
+    customPageContentPublish: "/api/api/custom/page/content/publish",
     appPackagePhysicallyDelete: "/api/api/app/apppackage/physically_delete",
     fieldList: "/api/api/app/bizproperty/list",
     fieldGet: "/api/api/app/bizproperty/get",

package/dist/goal-routes.js

@@ -610,6 +610,13 @@ export function goalRoute(registry, goal) {
                 firstCommands: [
                     DISCOVERY_AUTHORITY.readiness,
                     ...ladder.flatMap((step) => step.recipe?.command ? [step.recipe.command] : []),
+                    // r13 #3: `capability workflow --executable` is 23 KB and still did not
+                    // answer "how do I submit an approval" — the answer is a data.submit
+                    // recipe, which lives in a DIFFERENT capability. When the goal is about
+                    // moving an approval, hand over that example directly.
+                    ...(/审批|通过|驳回|提交|签收/.test(goal) && ordered.some((id) => id === "workflow" || id === "runtimeData")
+                        ? ["omc describe data.submit --example workflow-backed-data-submit"]
+                        : []),
                 ],
                 write,
                 ...(readish ? { readback: true } : {}),
@@ -635,6 +642,11 @@ export function goalRoute(registry, goal) {
         firstCommands.push(`omc commands --json --compact --lane ${route.lane}`);
     else
         firstCommands.push(`omc capability ${capabilityId}`);
+    // r13 #3: an approval-moving goal lands on the `workflow` capability whose
+    // 23 KB executable bundle never answered "how do I submit" — that answer is a
+    // data.submit recipe in another lane. Hand it over directly.
+    if (!readish && /审批|通过|驳回|提交|签收/.test(goal) && (capabilityId === "workflow" || capabilityId === "runtimeData"))
+        firstCommands.push("omc describe data.submit --example workflow-backed-data-submit");
     const whole = isWholePackageWrite(mode, goal, 1);
     return {
         status: "ok",

package/dist/lanes/custom-page.js

@@ -0,0 +1,283 @@
+import { z } from "zod";
+import { ToolRefusalError, defineTool } from "../tool-types.js";
+import { governedRead } from "../read.js";
+import { writeTool } from "../write.js";
+import { wireCall, wireRows, WireError } from "../wire.js";
+import { ENDPOINTS } from "../endpoints.js";
+import { capabilityArg, environmentArg } from "../args.js";
+import { resolveApplicationCode } from "../support.js";
+import { LANES } from "./lane-ids.js";
+import { FOLDER_LANE_CONTRACT } from "./folder-contract.js";
+/**
+ * Custom pages (自定义页面) — the JS/HTML page a customer embeds in the portal.
+ *
+ * Evidence: decompiled 8.6.26
+ * `cloudpivot-engine/com/authine/cloudpivot/web/api/controller/app/CustomPageController.java`
+ * (`@RequestMapping("/api/custom")`). Two rows move together:
+ *   - the app-tree node: `AppFunctionModel` type=Page, created by POST /create
+ *     with {name, code, parentId, appCode, menuPointType, pcAble, mobileAble,
+ *     openMode}. `menuPointType` is REQUIRED (the controller calls
+ *     `getMenuPointType().toString()` → NPE/50000 when null); for this controller
+ *     it is `CUSTOM_PAGE` (MenuPointType enum: URL/BIZ_SCHEME/REPORT/
+ *     CUSTOM_PAGE/WORKFLOW_CENTER_PAGE/AI_AGENT).
+ *   - the body: `CustomPageModel.draftContent` / `.publishedContent`, written by
+ *     /page/content/update (draft, sets existDraft=true) and /page/content/publish
+ *     (published, sets published=true). Both require the AppFunction to exist
+ *     (`getAppFunctionByCode(code)` → else BIZ_SCHEMA_NOT_EXIST) and both will
+ *     CREATE the CustomPageModel when absent, so "node first, then body" is the
+ *     only working order.
+ */
+const LANE = LANES.folder;
+const T = FOLDER_LANE_CONTRACT.tools;
+const MENU_POINT_TYPES = ["URL", "BIZ_SCHEME", "REPORT", "CUSTOM_PAGE", "WORKFLOW_CENTER_PAGE", "AI_AGENT"];
+/**
+ * Node read that tolerates the platform's "absent" answer: `/custom/get` throws
+ * 302033 BIZ_CUSTOM_SHEET_EMPTY (not null) when the row is missing, so a plain
+ * null check never fires and a delete stops being idempotent.
+ */
+async function readPageOrNull(session, code) {
+    try {
+        return (await wireCall(session, { path: ENDPOINTS.customPageGet, query: { code } })).data ?? null;
+    }
+    catch (error) {
+        if (error instanceof WireError && error.kind === "business" && (error.errcode === 302033 || error.errcode === 50000))
+            return null;
+        throw error;
+    }
+}
+function pickPage(row) {
+    return {
+        code: row.code ?? null,
+        name: row.name ?? null,
+        appCode: row.appCode ?? null,
+        parentId: row.parentId ?? null,
+        icon: row.icon ?? null,
+        openMode: row.openMode ?? null,
+        pcUrl: row.pcUrl ?? null,
+        mobileUrl: row.mobileUrl ?? null,
+        pcAble: row.pcAble ?? null,
+        mobileAble: row.mobileAble ?? null,
+        menuPointType: row.menuPointType ?? null,
+        published: row.published ?? null,
+        existDraft: row.existDraft ?? null,
+        ...(typeof row.draftContent === "string" ? { draftBytes: Buffer.byteLength(row.draftContent, "utf8") } : {}),
+        ...(typeof row.publishedContent === "string" ? { publishedBytes: Buffer.byteLength(row.publishedContent, "utf8") } : {}),
+    };
+}
+export function registerCustomPageTools(tools) {
+    tools.push(defineTool({
+        name: "custompage.list",
+        layer: "low",
+        kind: "read",
+        lane: LANE,
+        scope: T["custompage.list"].scope,
+        description: T["custompage.list"].description,
+        inputSchema: {
+            environment: environmentArg,
+            applicationCode: z.string().optional().describe("应用 code；省略用配置/默认应用"),
+            type: z.enum(["PC", "MOBILE"]).optional().describe("门户端过滤（NodeType）；省略两端口都列"),
+            capability: capabilityArg,
+        },
+        handler: async (ctx, args, self) => governedRead(ctx, self, args, async (session) => {
+            const appCode = await resolveApplicationCode(session, args.applicationCode);
+            // `/custom/list?modeType=` answers the CustomPageModel rows. The node face
+            // (`/custom/page/list_by_appcode`) filters NodeType.CustomPage while
+            // /custom/create forces NodeType.Page, so it answers [] for pages this tool
+            // creates (live 1.1.25) — do not use it for "which pages exist".
+            const rows = wireRows((await wireCall(session, { path: ENDPOINTS.customPageList, query: { modeType: "VUE_MODE" } })).data);
+            const pages = rows.map(pickPage).filter((page) => appCode === "" || String(page.appCode ?? "") === appCode);
+            return { applicationCode: appCode, count: pages.length, pages };
+        }),
+    }));
+    tools.push(defineTool({
+        name: "custompage.get",
+        layer: "low",
+        kind: "read",
+        lane: LANE,
+        scope: T["custompage.get"].scope,
+        description: T["custompage.get"].description,
+        inputSchema: {
+            environment: environmentArg,
+            code: z.string().min(1),
+            content: z.boolean().optional().describe("true = 同时读 draftContent/publishedContent 原文（大；默认只回字节数）"),
+            capability: capabilityArg,
+        },
+        handler: async (ctx, args, self) => governedRead(ctx, self, args, async (session) => {
+            const page = await readPageOrNull(session, args.code);
+            if (page === null)
+                throw new ToolRefusalError({ status: "refused", blocker: "custompage-absent", code: args.code, message: `自定义页 ${args.code} 不存在（/custom/get 回 302033）；先 custompage.list 或 custompage.create` });
+            const projected = pickPage(page);
+            // /custom/get answers the CustomPageModel row, which does not carry the
+            // tree parent — say so instead of letting parentId:null look like "root".
+            if (projected.parentId === null || projected.parentId === undefined)
+                projected.parentIdNote = "parentId 不在 /custom/get 的返回里（它属于应用树 AppFunction 行）；要改父节点请 custompage.update 显式传 parentId";
+            if (args.content !== true)
+                return { code: args.code, present: true, page: projected, contentHint: "要页面正文（draftContent/publishedContent 原文）加 content:true，或用 custompage.content.get" };
+            const body = (await wireCall(session, { path: ENDPOINTS.customPageContentGet, query: { code: args.code } })).data;
+            return {
+                code: args.code,
+                present: true,
+                page: projected,
+                content: {
+                    draftContent: body?.draftContent ?? null,
+                    publishedContent: body?.publishedContent ?? null,
+                    existDraft: body?.existDraft ?? null,
+                    published: body?.published ?? null,
+                },
+            };
+        }),
+    }));
+    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, "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 } };
+    });
+    tools.push(defineTool({
+        name: "custompage.content.get",
+        layer: "low",
+        kind: "read",
+        lane: LANE,
+        scope: T["custompage.content.get"].scope,
+        description: T["custompage.content.get"].description,
+        inputSchema: {
+            environment: environmentArg,
+            code: z.string().min(1),
+            part: z.enum(["draft", "published", "both"]).optional().describe("默认 both；只要一侧就指名，省输出"),
+            capability: capabilityArg,
+        },
+        handler: async (ctx, args, self) => governedRead(ctx, self, args, async (session) => {
+            const body = (await wireCall(session, { path: ENDPOINTS.customPageContentGet, query: { code: args.code } })).data;
+            if (body === null)
+                throw new ToolRefusalError({ status: "refused", blocker: "custompage-absent", code: args.code, message: `自定义页 ${args.code} 没有正文记录（/page/content/get 空）；先 custompage.create，再 custompage.content.update` });
+            const part = args.part ?? "both";
+            const draft = typeof body.draftContent === "string" ? body.draftContent : null;
+            const published = typeof body.publishedContent === "string" ? body.publishedContent : null;
+            return {
+                code: args.code,
+                existDraft: body.existDraft ?? null,
+                published: body.published ?? null,
+                ...(part !== "published" ? { draftContent: draft, draftBytes: draft === null ? 0 : Buffer.byteLength(draft, "utf8") } : {}),
+                ...(part !== "draft" ? { publishedContent: published, publishedBytes: published === null ? 0 : Buffer.byteLength(published, "utf8") } : {}),
+            };
+        }),
+    }));
+    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,
+                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, "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 } };
+    });
+}
+//# sourceMappingURL=custom-page.js.map

package/dist/lanes/field.js

@@ -301,7 +301,34 @@ export function registerFieldLane(tools) {
         // One seam owns field-change normalization, every reproduced gate, and the
         // wire body (src/field-change.ts), so configure_model and intent share it.
         const prepared = prepareFieldChange(args);
-        const performed = await wireCall(session, { path: ENDPOINTS.fieldCreate, method: "POST", body: fieldChangeWireBody(args, prepared) });
+        let performed;
+        try {
+            performed = await wireCall(session, { path: ENDPOINTS.fieldCreate, method: "POST", body: fieldChangeWireBody(args, prepared) });
+        }
+        catch (error) {
+            // r12 A5: the platform answers a bare 300005「数据模型已经存在！」when the
+            // code collides. BizObjectSchemaManagerImpl#addBizSchema looks the code up
+            // in the GLOBAL schema registry (`getBizObjectSchema(code)`), and child
+            // tables are registered there too (`schema.isSubSchema()` →
+            // `_addSubBizSchema`) — so a subtable code shares the model namespace and
+            // collides across models, not just inside this one. The registry lookup is
+            // not exposed over REST, so the occupier cannot be listed here; say that
+            // instead of leaving a bare platform code.
+            if (error instanceof WireError && error.kind === "business" && error.errcode === 300005)
+                throw new ToolRefusalError({
+                    status: "refused",
+                    blocker: "schema-code-taken",
+                    schemaCode: args.schemaCode,
+                    code: args.code,
+                    nextCommand: `omc call field.list --args '${JSON.stringify({ schemaCode: args.schemaCode, published: false })}'`,
+                    message: `code ${args.code} 已被占用（300005 数据模型已经存在）。**模型与子表共用同一个全局 code 命名空间**——` +
+                        `反编译取证的判定点是 BizObjectSchemaManagerImpl#addBizSchema 的 getBizObjectSchema(code)，子表走同一注册表（isSubSchema → _addSubBizSchema），` +
+                        `所以子表 code 与别的模型的子表/模型 code 撞了也会报这条，而不只是本模型内重复。` +
+                        `本模型内的重复本工具已提前拦住；剩下的是跨模型占用。平台没有「按 code 查占用者」的 REST 读面（只有 _addSubBizSchema 内部注册表），所以这里列不出占用者。` +
+                        `处理：换一个更具体的 code（建议 <模型前缀>_<语义>）；如果确信是上一轮残留，用 model-purge 清掉那个模型后再试。`,
+                });
+            throw error;
+        }
         const readback = await wireCall(session, { path: ENDPOINTS.fieldList, query: { schemaCode: args.schemaCode, isPublish: "false" } });
         const rows = wireRows(readback.data);
         return {

package/dist/lanes/folder-contract.js

@@ -15,6 +15,7 @@ export const FOLDER_WIRE = Object.freeze({
     defaults: "createFolder forces type=Folder, defaults parentId to the app package id (root) and does NOT reject duplicate names; updateFolder refuses parentId===id and only writes parentId when non-empty; deleteFolder refuses a non-empty folder (DIRECTORY_NOT_EMPTY) — delete is NOT recursive",
     tree: "apppackage/trees?appCode= returns a NESTED tree (folders carry children[]); reading only the top-level array makes a freshly created child folder look absent — flatten recursively and report path/depth",
     live: "2026-10-23 customer HAR replay: folders/create answered errcode 0 成功创建目录; after the token was attached apppackage/trees returned the full tree",
+    customPage: "CustomPageController(8.6.26, @RequestMapping \"/api/custom\"): POST /create takes AppFunctionVO and requires parentId + a non-null menuPointType (getMenuPointType().toString() NPEs to 50000 otherwise) and forces type=Page; POST /page/content/update writes draftContent (existDraft=true) and /page/content/publish writes publishedContent (published=true); BOTH first do getAppFunctionByCode(code) and throw BIZ_SCHEMA_NOT_EXIST when the tree node is missing — node first, then body",
 });
 export const FOLDER_LANE_CONTRACT = Object.freeze({
     lane: "app-tree-folders",
@@ -26,12 +27,19 @@ export const FOLDER_LANE_CONTRACT = Object.freeze({
         get: "folders/get",
         update: "folders/update",
         delete: "folders/delete",
+        customPageCreate: "custom/create",
+        customPageList: "custom/page/list_by_appcode",
+        customPageContentGet: "custom/page/content/get",
+        customPageContentUpdate: "custom/page/content/update",
+        customPageContentPublish: "custom/page/content/publish",
+        customPageDelete: "custom/delete",
     }),
     wire: FOLDER_WIRE,
     wireBindings: Object.freeze({
         endpoints: Object.freeze([behaviorBinding("test/app-folder-and-model-move.test.ts#model.move reparents the model; folder.delete refuses a non-empty folder", assertFolderContract)]),
         defaults: Object.freeze([behaviorBinding("test/app-folder-and-model-move.test.ts#model.move reparents the model; folder.delete refuses a non-empty folder", assertFolderContract)]),
         tree: Object.freeze([behaviorBinding("test/app-folder-and-model-move.test.ts#folder.create then folder.tree sees the folder (nested tree is flattened)", assertFolderContract)]),
+        customPage: Object.freeze([behaviorBinding("test/custom-page.test.ts#custompage.create then content.update/publish round-trips the body; body without a node is refused", assertFolderContract)]),
         live: Object.freeze([behaviorBinding("test/app-folder-and-model-move.test.ts#folder.create then folder.tree sees the folder (nested tree is flattened)", assertFolderContract)]),
     }),
     evidence: Object.freeze([
@@ -44,6 +52,18 @@ export const FOLDER_LANE_CONTRACT = Object.freeze({
         "folder.create": Object.freeze({ scope: "app-tree folder create (folders/create)", description: "新建目录：folders/create 省略 parentId 建顶层目录；同父同名默认拒绝（folder-duplicate）" }),
         "folder.update": Object.freeze({ scope: "app-tree folder rename/move (folders/update)", description: "重命名/挂载目录（不移动目录内模型，模型用 model.move）；parentId 不可等于自身" }),
         "folder.delete": Object.freeze({ scope: "app-tree folder delete (folders/delete, non-recursive)", description: "删除空目录：非递归，有子节点回 DIRECTORY_NOT_EMPTY（工具先查子节点，拒 folder-not-empty）" }),
+        // Custom pages ride the SAME app tree (AppFunction type=Page); the body is a
+        // separate CustomPageModel row. Evidence: CustomPageController (@RequestMapping
+        // "/api/custom") — /create needs parentId + menuPointType (null → NPE/50000),
+        // and /page/content/* requires the AppFunction to already exist.
+        "custompage.list": Object.freeze({ scope: "app-tree custom page list (custom/page/list_by_appcode)", description: "列自定义页：按应用读 AppFunction(type=Page) 菜单节点，回 code/name/parentId/端点可见性（正文体积只回字节数）" }),
+        "custompage.get": Object.freeze({ scope: "app-tree custom page node (custom/get)", description: "读单个自定义页节点；content:true 时一并读 draftContent/publishedContent 原文（默认只回字节数）" }),
+        "custompage.create": Object.freeze({ scope: "app-tree custom page create (custom/create, AppFunction type=Page + CustomPageModel)", description: "新建自定义页节点：custom/create 需要 name/code/parentId/appCode 与 menuPointType（工具默认 CUSTOM_PAGE）；建完再用 custompage.content.update 写正文" }),
+        "custompage.update": Object.freeze({ scope: "app-tree custom page update (custom/update)", description: "改自定义页节点（名称/父节点/可见性/图标）；parentId 平台强制必填，省略会 50000，工具要求显式传入" }),
+        "custompage.content.get": Object.freeze({ scope: "custom page body read (custom/page/content/get)", description: "读页面正文 draftContent/publishedContent（可 part:draft|published|both 省输出）" }),
+        "custompage.content.update": Object.freeze({ scope: "custom page body draft write (custom/page/content/update)", description: "写页面正文草稿；publish:true 时同一调用再发布。草稿/发布是两个字段，门户读 publishedContent" }),
+        "custompage.content.publish": Object.freeze({ scope: "custom page body publish (custom/page/content/publish)", description: "发布页面正文（省略 content 则发布当前草稿），回读 publishedMatches 自证" }),
+        "custompage.delete": Object.freeze({ scope: "custom page delete (custom/delete)", description: "删除自定义页（已缺席即幂等跳过），回读 absent 自证" }),
     }),
 });
 export function assertFolderContract() {
@@ -55,5 +75,13 @@ export function assertFolderContract() {
         throw new Error("folder contract must pin the non-recursive delete refusal");
     if (!FOLDER_WIRE.tree.includes("NESTED"))
         throw new Error("folder contract must pin the nested tree shape");
+    // Custom pages: the two-row model (tree node + body row) and the NPE-on-null
+    // menuPointType are the facts a future edit must not lose.
+    if (!FOLDER_WIRE.customPage.includes("menuPointType"))
+        throw new Error("custom page contract must pin the required menuPointType");
+    if (!FOLDER_WIRE.customPage.includes("BIZ_SCHEMA_NOT_EXIST"))
+        throw new Error("custom page contract must pin node-before-body");
+    assertDescriptionCarries(FOLDER_LANE_CONTRACT, "custompage.create", ["parentId", "menuPointType", "content.update"]);
+    assertDescriptionCarries(FOLDER_LANE_CONTRACT, "custompage.content.update", ["publish", "publishedContent"]);
 }
 //# sourceMappingURL=folder-contract.js.map

package/dist/lanes/folder-coverage.js

@@ -12,5 +12,19 @@ export const FOLDER_COVERAGE = declareLaneCoverage(FOLDER_LANE_CONTRACT.lane, [
             claim("folder.delete", T["folder.delete"].scope),
         ],
     },
+    {
+        capability: "Custom pages (自定义页面): app-tree node + JS/HTML body (draft/publish)",
+        evidence: ["issue/2026-10-25-inspection-r15-omc-frictions.md", "packages/omc-cli/src/lanes/custom-page.ts"],
+        tools: [
+            claim("custompage.list", T["custompage.list"].scope),
+            claim("custompage.get", T["custompage.get"].scope),
+            claim("custompage.create", T["custompage.create"].scope),
+            claim("custompage.update", T["custompage.update"].scope),
+            claim("custompage.content.get", T["custompage.content.get"].scope),
+            claim("custompage.content.update", T["custompage.content.update"].scope),
+            claim("custompage.content.publish", T["custompage.content.publish"].scope),
+            claim("custompage.delete", T["custompage.delete"].scope),
+        ],
+    },
 ]);
 //# sourceMappingURL=folder-coverage.js.map

package/dist/lanes/list-view.js

@@ -302,6 +302,21 @@ export function registerListViewLane(tools) {
                 conditions,
                 actionCodes: readArray(model, "queryActions").map((action) => action.actionCode).filter((value) => value !== undefined),
                 buttonCount: readArray(model, "customButtons").length,
+                // r14 F5 / r11 #6: the default face exposed only `buttonCount`, so a
+                // caller could not prove WHICH buttons landed (it had to trust the
+                // configure readback or cross-check rule.list). Codes + bindings cost
+                // ~40 B per button and answer "did my buttons land?"; the full
+                // script/actionConfig payload stays behind `buttons:true`.
+                buttonCodes: readArray(model, "customButtons").map((button) => button.code).filter((value) => typeof value === "string"),
+                buttonBindings: readArray(model, "customButtons")
+                    .filter((button) => typeof button.code === "string")
+                    .map((button) => ({
+                    code: button.code,
+                    ...(button.bindAction !== undefined ? { bindAction: button.bindAction } : {}),
+                    ...(button.targetCode !== undefined ? { targetCode: button.targetCode } : {}),
+                    ...(button.targetModel !== undefined ? { targetModel: button.targetModel } : {}),
+                    ...(button.targetForm !== undefined ? { targetForm: button.targetForm } : {}),
+                })),
                 // Button scripts live in h_biz_button.actionConfig (a JSON STRING)
                 // whose `scriptData` holds the source for bindAction=SCRIPT. Surfacing
                 // them here removes the "listview.get → artifact → JSON.parse →

package/dist/lanes/model.js

@@ -612,6 +612,8 @@ export function registerModelLane(tools) {
                 blocker: "model-referenced-by",
                 schemaCode: args.schemaCode,
                 referencingModels,
+                deletionOrder: [...referencingModels.map((model) => model.schemaCode), args.schemaCode],
+                nextCommand: `omc call model.delete --args '${JSON.stringify({ schemaCode: referencingModels[0].schemaCode })}'`,
                 message: `${args.schemaCode} 被模型 ${referencingModels.map((model) => model.schemaCode).join("、")} 的关联字段引用，不能删除（服务端 deleteFunctions 的异步拒绝已提前到调用时）。依赖倒序清理：先删引用方模型（或先删其关联字段），再删被引用模型；引用方物理删除的逐列异步级联需 40-60s，完成后再删本模型。`,
             });
         }

package/dist/lanes/organization.js

@@ -377,12 +377,22 @@ export function registerOrganizationLane(tools) {
                 }
             }
         }
-        if (users.length > 0)
+        if (users.length > 0) {
+            // Name every member and hand over a runnable transfer for the first one:
+            // "先看人再转出" left the caller to assemble the transfer args (item 9).
+            const members = users.map((row) => ({ id: row.id ?? row.userId ?? null, name: row.name ?? null, username: row.username ?? null }));
+            const parentId = walked.rows.find((row) => row.id === String(args.deptId))?.parentId ?? "";
+            const first = members.find((member) => typeof member.id === "string" && member.id.length > 0);
             throw new ToolRefusalError({
-                status: "refused", blocker: "department-has-users", deptId: String(args.deptId), users: users.length,
-                nextCommand: `omc call org.department.users --args '${JSON.stringify({ deptId: String(args.deptId) })}'`,
-                message: `部门 ${args.deptId} 下还有 ${users.length} 名员工，平台拒绝删除（200002）。先用 org.department.users 看人，再用 org.user.transferDepartment 转出（平台不允许删带人的部门）。`,
+                status: "refused", blocker: "department-has-users", deptId: String(args.deptId), users: users.length, members,
+                nextCommand: first && parentId
+                    ? `omc call org.user.transferDepartment --args '${JSON.stringify({ userId: first.id, departmentId: parentId })}'`
+                    : `omc call org.department.users --args '${JSON.stringify({ deptId: String(args.deptId) })}'`,
+                message: `部门 ${args.deptId} 下还有 ${users.length} 名员工，平台拒绝删除（200002）。成员：${members.map((member) => `${member.name ?? "?"}(${member.id ?? "?"})`).join("、")}。` +
+                    `平台不允许删带人的部门，也不提供"随部门级联转出"；逐个 org.user.transferDepartment 转到 ${parentId ? `父部门 ${parentId}` : "目标部门"} 后再删。` +
+                    `（force 只处理子部门，不搬人——搬人是组织语义决策，工具不替你做。）`,
             });
+        }
         await wireCall(session, { path: ENDPOINTS.organizationDepartmentDelete, query: { ...orgQuery(session), id: args.deptId } });
         return { performed: { errcode: 0 }, readback: { deptId: args.deptId, deleted: true, usersBeforeDelete: users.length, deletedChildren } };
     });
@@ -429,7 +439,21 @@ export function registerOrganizationLane(tools) {
         const userId = String(data?.id ?? "");
         if (!userId)
             throw new ToolRefusalError({ status: "refused", blocker: "wire-shape", message: "平台未返回用户 id；先 org.user.search 回读确认" });
-        return { performed: { errcode: 0 }, readback: { userId, name: data?.name ?? args.name, username: data?.username ?? args.username, departmentId: data?.departmentId ?? args.departmentId } };
+        return {
+            performed: { errcode: 0 },
+            readback: {
+                userId,
+                name: data?.name ?? args.name,
+                username: data?.username ?? args.username,
+                departmentId: data?.departmentId ?? args.departmentId,
+                // 1.1.25 does not echo `active` on add and does not honour an update to
+                // it (r15 P7): the flag looks derived from account activation/binding.
+                // Say so, so nobody re-creates the user to "fix" it.
+                ...(args.active !== undefined
+                    ? { activeWarning: `平台不回读 active（1.1.25 上它疑似由账号激活/绑定派生，不是可直接写的开关）。启停账号用 status=ENABLE/DISABLE/LOCK；不要为改 active 新建用户。` }
+                    : {}),
+            },
+        };
     });
     writeTool(tools, "org.user.update", LANE, SCOPES.userUpdate, "改员工（`POST organization/user/modify`）。先 user/info 读现状再合并；工具强制补 `deptIds:[]` 等四个数组——平台 modified 对 null 的 deptIds 直接 NPE（50000，真机 1.1.25）。可改姓名/部门/手机/邮箱/角色/启停。", {
         userId: z.string().min(1),

package/dist/lanes/rule-lifecycle.js

@@ -220,13 +220,16 @@ export function registerRuleLifecycleLane(tools) {
             if (error instanceof WireError && error.kind === "business" && error.errcode === 550001)
                 throw new ToolRefusalError({
                     status: "refused",
-                    blocker: "rule-not-custom-trigger",
+                    blocker: "rule-not-executable",
                     schemaCode: args.schemaCode,
                     ruleCode: args.ruleCode,
-                    nextCommand: `omc call rule.get --args '${JSON.stringify({ schemaCode: args.schemaCode, ruleCode: args.ruleCode })}'`,
-                    message: `平台 launcher 运行时没有注册规则 ${args.ruleCode}（550001 业务规则不存在）。\`rule.run\` 走的是「按钮/自定义触发」端点，` +
-                        `只认 CUSTOM_NODE 触发的规则；数据事件（Create/Update/…）的规则不会注册在这里。` +
-                        `要看规则图里有没有 CUSTOM_NODE，用 rule.get 看 nodes；要验证数据事件规则请走 data.submit/data.update，要验证按钮请绑到列表/表单按钮后在门户点击。`,
+                    nextCommand: `omc call rule.enable --args '${JSON.stringify({ schemaCode: args.schemaCode, ruleCode: args.ruleCode })}'`,
+                    message: `550001「业务规则不存在」在这里的真实含义是「该规则当前不可执行」，不是规则不存在，也不是「只认 CUSTOM_NODE」。` +
+                        `反编译 8.6.26 的 BusinessRuleTableImpl#getExecutableBySchemaCodeAndCode 是唯一判定：` +
+                        `① **DRAFT 行**必须存在；② DRAFT 行 enabled=true **且** status != DISABLED；③ 至少一条 PUBLISH 版本。` +
+                        `rule.save --publish 只写 PUBLISH 行，**DRAFT 行的 status 仍是 DISABLED**——所以发布完直接 rule.run 必然 550001。` +
+                        `修法：rule.enable（它先 publish 再调平台 /enable，把 DRAFT 行 status 置 ENABLED）。` +
+                        `注意 rule.list 显示的是 PUBLISH 行的 enabled/status，看起来"已启用"但运行期读的是 DRAFT 行——不要用 list 判定可执行性。`,
                 });
             throw error;
         }

package/dist/lanes/runtime-data.js

@@ -979,6 +979,19 @@ export function registerRuntimeDataLane(tools) {
         isSimulative: z.boolean().optional(),
         ...readbackProjectionArgs,
     }, async (session, args) => {
+        // r13 #5: an EMPTY STRING was forwarded verbatim, so the platform answered
+        // 100002「参数为空」with no hint which parameter. Absent and blank are not
+        // the same intent: refuse the blank one by name, zero wire.
+        const blank = ["workItemId", "workflowInstanceId", "workflowCode"].filter((key) => typeof args[key] === "string" && args[key].trim().length === 0 && args[key].length > 0);
+        if (blank.length > 0)
+            throw new ToolRefusalError({
+                status: "refused",
+                blocker: "submit-blank-parameter",
+                schemaCode: args.schemaCode,
+                parameters: blank,
+                message: `这些参数传了空白字符串：${blank.join("、")}。平台会把这个空白当"参数为空"回 100002（SYS_PARAMETER_EMPTY），` +
+                    `而错误里不会说是哪一个。要么给出真实 id，要么整个省略该键（省略 ≠ 传空串）。`,
+            });
         const hasWorkItem = typeof args.workItemId === "string" && args.workItemId.trim().length > 0;
         const hasInstance = typeof args.workflowInstanceId === "string" && args.workflowInstanceId.trim().length > 0;
         const targetObjectId = typeof args.bizObjectId === "string" && args.bizObjectId.trim() ? args.bizObjectId.trim() : null;
@@ -1215,7 +1228,9 @@ export function registerRuntimeDataLane(tools) {
             // An approval submit returns the status + the fields the caller submitted,
             // not the whole row: r12's 25 approvals were the largest read face at
             // 55.6 KB. Explicit summary/fields/full keep their contract.
-            const approvalDelta = hasWorkItem && args.summary !== true && args.full !== true && !(Array.isArray(args.fields) && args.fields.length > 0);
+            // Pure-instance submits (workflowInstanceId without workItemId) go
+            // through the same engine path and deserve the same delta (item 11).
+            const approvalDelta = (hasWorkItem || hasInstance) && args.summary !== true && args.full !== true && !(Array.isArray(args.fields) && args.fields.length > 0);
             readback = {
                 ...readback,
                 workflowInstanceId: effectiveInstanceId,

package/dist/lanes/workflow.js

@@ -2214,7 +2214,7 @@ export function registerWorkflowLane(tools) {
         const activityNames = Object.fromEntries(rawActivityRows
             .map((row) => [String(row.activityCode ?? ""), effectiveActivityName(row)])
             .filter(([code]) => code !== ""));
-        return { performed: { errcode: performed.errcode }, readback: { workflowCode: args.code, activities: Array.isArray(data.activities) ? data.activities.length : rawActivityRows.length, templateType: data.templateType ?? null, activityNames, ...(participantWarnings.length ? { participantWarnings } : {}), ...(rejectWarnings.length ? { workflowWarnings: rejectWarnings } : {}), ...(branchEdges.length ? { routesInherited: { edges: branchEdges, hint: "本次未传 routes/edges：以上分支边沿用草稿（含 else 兜底）。要改连线请显式回传完整 routes" } } : {}), ...(renamedInPlace.length ? { renamedInPlace, renamedInPlaceHint: "改名已同 code 原地生效（载体 name_i18n，displayName 才是当前名；activityName 是首建值，平台不再变更）" } : {}), ...(renamedActivities.length ? { renamedActivities, renamedHint: "类型变更铸了新码（上表 from→to）且旧码已失效——后续读写一律用 to；再用旧码 from 会被当作新节点追加" } : {}), workflowRenderCompat: workflowRenderCompat(data) } };
+        return { performed: { errcode: performed.errcode }, readback: { workflowCode: args.code, activities: Array.isArray(data.activities) ? data.activities.length : rawActivityRows.length, templateType: data.templateType ?? null, activityNames, rollbackHint: `本次改动的 before 快照已记录：omc rollback plan --target workflow:${args.schemaCode}/${args.code} 查看可回退项，omc rollback apply --target … --step <n> 执行（草稿回退后仍需 workflow.publish 才生效）`, ...(participantWarnings.length ? { participantWarnings } : {}), ...(rejectWarnings.length ? { workflowWarnings: rejectWarnings } : {}), ...(branchEdges.length ? { routesInherited: { edges: branchEdges, hint: "本次未传 routes/edges：以上分支边沿用草稿（含 else 兜底）。要改连线请显式回传完整 routes" } } : {}), ...(renamedInPlace.length ? { renamedInPlace, renamedInPlaceHint: "改名已同 code 原地生效（载体 name_i18n，displayName 才是当前名；activityName 是首建值，平台不再变更）" } : {}), ...(renamedActivities.length ? { renamedActivities, renamedHint: "类型变更铸了新码（上表 from→to）且旧码已失效——后续读写一律用 to；再用旧码 from 会被当作新节点追加" } : {}), workflowRenderCompat: workflowRenderCompat(data) } };
     }, (args) => {
         // Zero-wire refusal (ticket 77): fires in semanticGate BEFORE the
         // governed pipeline — including the rollback before-capture read.

package/dist/model-purge.js

@@ -302,11 +302,17 @@ export async function cmdModelPurge(args) {
     let failed = instanceOutcome.failed;
     const unremovableInstances = instanceOutcome.unremovableInstances;
     // 2) the model — everything else cascades with it.
+    let referrers = [];
     if (!failed) {
         const outcome = await call("model.delete", { schemaCode });
         const readback = outcome.result.readback;
         const absent = readback?.absent === true || outcome.result.performed?.skipped === "already-absent";
-        record(`model.delete:${schemaCode}`, outcome.ok || absent, outcome.ok || absent ? (readback ? { cascades: true, absent: readback.absent ?? null } : undefined) : { message: refusalText(outcome.result) });
+        referrers = Array.isArray(outcome.result.referencingModels)
+            ? outcome.result.referencingModels.map((row) => String(row.schemaCode ?? "")).filter((code) => code.length > 0)
+            : [];
+        record(`model.delete:${schemaCode}`, outcome.ok || absent, outcome.ok || absent
+            ? (readback ? { cascades: true, absent: readback.absent ?? null } : undefined)
+            : { message: refusalText(outcome.result), ...(referrers.length > 0 ? { referencedBy: referrers } : {}) });
         if (!outcome.ok && !absent)
             failed = true;
     }
@@ -321,7 +327,16 @@ export async function cmdModelPurge(args) {
         ...(failed
             ? {
                 nextAction: "fix-and-rerun",
-                message: "在失败的这一步停下（幂等，可修好后重跑同一条命令）。已成功的步骤不会重复破坏。",
+                ...(referrers.length > 0
+                    ? {
+                        blockedBy: referrers,
+                        deletionOrder: [...referrers, schemaCode],
+                        nextCommand: `omc model-purge --code ${referrers[0]} --purge-instances --apply`,
+                    }
+                    : {}),
+                message: referrers.length > 0
+                    ? `${schemaCode} 仍被 ${referrers.join("、")} 的关联字段引用，模型不能删（平台 deleteFunctions 的异步拒绝已提前到调用时）。按 deletionOrder 先清引用方，再重跑本命令。`
+                    : "在失败的这一步停下（幂等，可修好后重跑同一条命令）。已成功的步骤不会重复破坏。",
             }
             : unremovableInstances.length > 0
                 ? {

package/dist/rule-support.js

@@ -855,7 +855,15 @@ export async function executeRuleSaveWrite(session, args) {
                 ...(lintWarnings.length > 0 ? { lintWarnings } : {}),
                 ...(lintHazards.length > 0 ? { lintHazards } : {}),
                 customTrigger: customTriggerApplied,
-                ...(customTriggerApplied ? {} : { customTriggerHint: "图中没有 CUSTOM_NODE 触发节点：rule.run（domain_service_runtime）只注册自定义触发规则，数据事件规则请在 submit/update 时触发或绑到列表/表单按钮" }),
+                // publish only mints the PUBLISH row; the runtime gate
+                // (BusinessRuleTableImpl#getExecutableBySchemaCodeAndCode) reads the
+                // DRAFT row's enabled+status, and no read face exposes that pair
+                // unambiguously (the list projection surfaces the PUBLISH row). So do
+                // NOT claim an `executable` boolean — state the precondition instead.
+                // Saying "published" without this is what cost r15 four rule.run attempts.
+                executableRequires: "rule.enable",
+                executableHint: "publish 只写 PUBLISH 行，不等于可执行：运行时按 DRAFT 行的 enabled + status 判定（BusinessRuleTableImpl#getExecutableBySchemaCodeAndCode），而 list 面显示的是 PUBLISH 行。用 rule.run / domain_service_runtime 前先 rule.enable（它 publish 后再调平台 /enable，把 DRAFT 行 status 置 ENABLED）。",
+                ...(customTriggerApplied ? {} : { customTriggerHint: "图中没有 CUSTOM_NODE 触发节点：门户按钮/流程按钮调用该规则时会按各自的触发面执行；rule.run 也能执行（它不要求 CUSTOM_NODE），执行时以 BUTTON 触发类型跑同一张图" }),
                 id: effective?.id ?? undefined,
                 ruleVersion: effective?.ruleVersion,
                 latestPublished: effective?.latestPublished,
@@ -874,7 +882,7 @@ export async function executeRuleSaveWrite(session, args) {
             ...(lintWarnings.length > 0 ? { lintWarnings } : {}),
             ...(lintHazards.length > 0 ? { lintHazards } : {}),
             customTrigger: customTriggerApplied,
-            ...(customTriggerApplied ? {} : { customTriggerHint: "图中没有 CUSTOM_NODE 触发节点：rule.run（domain_service_runtime）只注册自定义触发规则，数据事件规则请在 submit/update 时触发或绑到列表/表单按钮" }),
+            ...(customTriggerApplied ? {} : { customTriggerHint: "图中没有 CUSTOM_NODE 触发节点：门户按钮/流程按钮调用该规则时会按各自的触发面执行；rule.run 也能执行（它不要求 CUSTOM_NODE），执行时以 BUTTON 触发类型跑同一张图" }),
             id: effective?.id ?? undefined,
             ruleVersion: effective?.ruleVersion,
             latestPublished: effective?.latestPublished,

package/dist/tools.js

@@ -5,6 +5,7 @@ import { registerEnvironmentLane } from "./lanes/environment.js";
 import { registerAppLane } from "./lanes/app.js";
 import { registerDictionaryLane } from "./lanes/dictionary.js";
 import { registerFolderLane } from "./lanes/folder.js";
+import { registerCustomPageTools } from "./lanes/custom-page.js";
 import { registerModelLane } from "./lanes/model.js";
 import { registerFieldLane } from "./lanes/field.js";
 import { registerDataRuleLane } from "./lanes/datarule.js";
@@ -37,6 +38,7 @@ export function buildToolRegistry() {
     registerDictionaryLane(tools);
     registerModelLane(tools);
     registerFolderLane(tools);
+    registerCustomPageTools(tools);
     registerFieldLane(tools);
     registerDataRuleLane(tools);
     registerFormLane(tools);

package/dist/write.js

@@ -85,8 +85,23 @@ async function governedWrite(ctx, tool, args, execute, dryRunPayload) {
                 };
             if (error instanceof ToolRefusalError)
                 throw error;
-            if (error instanceof WireError)
+            if (error instanceof WireError) {
+                // authine-orm Serializer.update/delete throws "Object <id> is not
+                // serialized." when the entity handle was never loaded from the store.
+                // That is a PLATFORM object-state error, not a shape error — reported as
+                // `wire-business` the caller reads "my JSON is wrong" and retries the
+                // wrong thing (r12 A6: rule.save on a preset Create row, self-healed by
+                // delete+rebuild). Name the state and the two recoveries.
+                if (/is not serialized|does not serialized/i.test(error.message))
+                    return {
+                        status: "refused",
+                        blocker: "orm-object-state",
+                        errcode: error.errcode,
+                        message: `${error.message}——这是平台 ORM 的对象状态错误（Serializer.update/delete 要求实体先被装载），不是入参或规则图的形状问题。` +
+                            "同一份入参再保存一次通常即恢复。持续复现就换行：rule.delete 后重建（rule.save 会铸新记录），或用 rule.get 读回完整行再 rule.node.update 改一处——不要继续重试同一份 payload。",
+                    };
                 return { status: "refused", blocker: `wire-${error.kind}`, errcode: error.errcode, message: error.message, ...(error.diagnostic ? { diagnostic: error.diagnostic } : {}) };
+            }
             throw error;
         }
         // A write tool that runs a step chain (field.update cascadeRepublish) may

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stalfh233/omc-cli",
-  "version": "0.4.90",
+  "version": "0.4.92",
   "description": "CloudPivot 8.6 configuration capability CLI — governed, fail-closed, coverage-manifest bounded.",
   "type": "module",
   "bin": {
@@ -50,9 +50,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@stalfh233/omc-fake-platform": "0.4.90",
+    "@stalfh233/omc-fake-platform": "0.4.92",
     "commander": "14.0.3",
-    "omc-core": "0.4.90",
+    "omc-core": "0.4.92",
     "proper-lockfile": "4.1.2",
     "write-file-atomic": "6.0.0",
     "zod": "^3.23.8",

package/skills/omc-capabilities.md

@@ -60,8 +60,8 @@ only the section for the capability you need —
 ## 应用目录（分组）`folder`
 
 - **能做哪些事**：读应用树（目录 + 模型，递归展平带 `path/depth`）、建目录、改名/挂载、删除空目录；配合 `model.move` 把模型放进目录。
-- **工具**：`folder.tree`、`folder.create`、`folder.update`、`folder.delete`、`model.move`
-- **边界 / 陷阱**：`folder.create` 省略 `parentId` 建的是**顶层目录**（平台默认挂应用根）；平台**不校验重名**（工具默认同父同名拒绝，并列同名传 `allowDuplicate:true`）；`folder.delete` **非递归**（有子节点即拒 `folder-not-empty`）；应用树是**嵌套** `children`，`folder.tree` 已展平并给 `path/depth`——只看顶层会误判"目录没建成"。模型进目录用 `model.move {schemaCode, folderId}`，`folderId` 必须是目录 **id**（给名字回 `folder-not-found` / 跨应用回 `folder-other-application`）。
+- **工具**：`folder.tree`、`folder.create`、`folder.update`、`folder.delete`、`model.move`；自定义页面（同一棵应用树）：`custompage.list`、`custompage.get`、`custompage.create`、`custompage.update`、`custompage.content.get`、`custompage.content.update`、`custompage.content.publish`、`custompage.delete`
+- **边界 / 陷阱**：`folder.create` 省略 `parentId` 建的是**顶层目录**（平台默认挂应用根）；平台**不校验重名**（工具默认同父同名拒绝，并列同名传 `allowDuplicate:true`）；`folder.delete` **非递归**（有子节点即拒 `folder-not-empty`）；应用树是**嵌套** `children`，`folder.tree` 已展平并给 `path/depth`——只看顶层会误判"目录没建成"。模型进目录用 `model.move {schemaCode, folderId}`，`folderId` 必须是目录 **id**（给名字回 `folder-not-found` / 跨应用回 `folder-other-application`）。**自定义页面是两行**：应用树节点（AppFunction type=Page，`custompage.create` 需要 `parentId`；`menuPointType` 平台必填，省略会 NPE→50000，工具默认 `CUSTOM_PAGE`）+ 页面正文（`draftContent`/`publishedContent`）。**必须先建节点再写正文**：`/page/content/*` 先按 code 查 AppFunction，缺节点回 `BIZ_SCHEMA_NOT_EXIST`。门户读的是 `publishedContent`——`content.update` 只写草稿，上线要 `content.publish`（或 update 传 `publish:true`）。页面 JS 若要复用平台对象，按在线 JS 的宿主对象约定写，别假设 `window.axios`。
 
 ## 数据字典 `dictionary`