@stalfh233/omc-cli 0.4.76 → 0.4.78

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

@@ -815,6 +815,7 @@
       "tools": [
         "model.create",
         "model.update",
+        "model.move",
         "model.delete",
         "model.deleteMany",
         "model.setSummary",
@@ -823,7 +824,8 @@
         "model.inspect"
       ],
       "scopes": [
-        "create publish physical delete absence read list inspect"
+        "create publish physical delete absence read list inspect",
+        "move a model's app-tree node to another folder (bizmodels/update parentId)"
       ]
     },
     {
@@ -1328,6 +1330,38 @@
       "scopes": [
         "report tree read page metadata BI config chart data create update delete configure"
       ]
+    },
+    {
+      "capability": "App-tree folders (目录/分组): read flattened tree, create, rename/move, non-recursive delete",
+      "status": "executable",
+      "scope": "App application-tree folders: flattened tree read with path/depth, folder create (omitted parentId = root), rename/reparent, non-recursive delete, and model reparenting.",
+      "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/AppFunctionController.java"
+        },
+        {
+          "path": "cp-sources/backend/decompiled-full/launcher-8.6.26/cloudpivot-metadata-8.6.26/com/authine/cloudpivot/metadata/history/apppackage/service/ApplicationFacadeImpl.java"
+        },
+        {
+          "path": "packages/omc-cli/src/lanes/folder.ts"
+        }
+      ],
+      "lane": "app-tree-folders",
+      "notes": "Live 2026-10-23 customer HAR: POST /api/app/folders/create answered errcode 0 成功创建目录; trees are nested (children[]) and must be flattened.",
+      "tools": [
+        "folder.tree",
+        "folder.create",
+        "folder.update",
+        "folder.delete"
+      ],
+      "scopes": [
+        "app-tree folder/model tree (flattened with path/depth)",
+        "app-tree folder create (folders/create)",
+        "app-tree folder rename/move (folders/update)",
+        "app-tree folder delete (folders/delete, non-recursive)"
+      ]
     }
   ]
 }

package/dist/capability-overview.js

@@ -36,6 +36,16 @@ const SURFACES = [
         intent: { level: "none", note: "未覆盖；用 omc call app.*。" },
         notes: "环境已带默认 applicationCode，建模不必先建应用。",
     },
+    {
+        id: "folder",
+        title: "应用目录（分组）",
+        lane: LANES.folder,
+        description: "应用树目录：读（递归展平带 path/depth）、建、改名/挂载、非递归删除。",
+        operations: ["tree", "create", "update", "delete"],
+        requires: ["app"],
+        intent: { level: "none", note: "未覆盖；用 omc call folder.*。移动模型用 model.move。" },
+        notes: "省略 parentId 建顶层目录（平台默认挂应用根）；平台不校验重名（工具默认同父同名拒绝）；删除非递归（有子节点回 DIRECTORY_NOT_EMPTY）；应用树是嵌套 children，folder.tree 已展平。",
+    },
     {
         id: "dictionary",
         title: "数据字典",
@@ -51,7 +61,7 @@ const SURFACES = [
         title: "业务模型",
         lane: LANES.model,
         description: "模型生命周期：创建、改名、物理删除、存在性。",
-        operations: ["create", "update", "delete", "deleteMany", "setSummary"],
+        operations: ["create", "update", "move", "delete", "deleteMany", "setSummary"],
         intent: { level: "partial", note: "create/update 与 delete（absent:true）已声明式；deleteMany/setSummary 未覆盖。" },
     },
     {

package/dist/contract-resources.js

@@ -5,6 +5,7 @@ import { DATARULE_LANE_CONTRACT } from "./lanes/datarule-contract.js";
 import { DICTIONARY_LANE_CONTRACT } from "./lanes/dictionary-contract.js";
 import { ENVIRONMENT_LANE_CONTRACT } from "./lanes/environment-contract.js";
 import { FIELD_LANE_CONTRACT } from "./lanes/field-contract.js";
+import { FOLDER_LANE_CONTRACT } from "./lanes/folder-contract.js";
 import { FORM_LANE_CONTRACT } from "./lanes/form-contract.js";
 import { LIST_VIEW_LANE_CONTRACT } from "./lanes/list-view-contract.js";
 import { META_LANE_CONTRACT } from "./lanes/meta-contract.js";
@@ -22,6 +23,7 @@ export const LANE_CONTRACTS = Object.freeze([
     DICTIONARY_LANE_CONTRACT,
     ENVIRONMENT_LANE_CONTRACT,
     FIELD_LANE_CONTRACT,
+    FOLDER_LANE_CONTRACT,
     FORM_LANE_CONTRACT,
     LIST_VIEW_LANE_CONTRACT,
     META_LANE_CONTRACT,

package/dist/coverage-registry.js

@@ -7,6 +7,7 @@ import { DATARULE_COVERAGE } from "./lanes/datarule-coverage.js";
 import { FIELD_COVERAGE } from "./lanes/field-coverage.js";
 import { FORM_COVERAGE } from "./lanes/form-coverage.js";
 import { LIST_VIEW_COVERAGE } from "./lanes/list-view-coverage.js";
+import { FOLDER_COVERAGE } from "./lanes/folder-coverage.js";
 import { MODEL_COVERAGE } from "./lanes/model-coverage.js";
 import { ONLINE_JS_COVERAGE } from "./lanes/online-js-coverage.js";
 import { RULE_LIFECYCLE_COVERAGE } from "./lanes/rule-lifecycle-coverage.js";
@@ -23,6 +24,7 @@ const DECLARATIONS = Object.freeze([
     ...APP_COVERAGE,
     ...DICTIONARY_COVERAGE,
     ...MODEL_COVERAGE,
+    ...FOLDER_COVERAGE,
     ...FIELD_COVERAGE,
     ...DATARULE_COVERAGE,
     ...FORM_COVERAGE,

package/dist/endpoints.js

@@ -17,6 +17,22 @@ export const ENDPOINTS = {
     modelGetSummary: "/api/api/app/bizmodels/get_summary",
     modelUpdateSummary: "/api/api/app/bizmodels/update_summary",
     modelUpdate: "/api/api/app/bizmodels/update",
+    /**
+     * App-tree FOLDERS (目录/分组). AppFunctionController (/api/app/folders,
+     * 8.6.26 :90-260):
+     *   POST create  body AppFunctionVO {appCode, name, name_i18n?, parentId?, code?, icon?}
+     *   GET  get     ?folderId=
+     *   POST update  body AppFunctionVO {id, name, name_i18n?, parentId?}
+     *   POST delete  ?folderId=   (refuses a non-empty folder: DIRECTORY_NOT_EMPTY)
+     * createFolder defaults parentId to the app package id (root) and forces
+     * type=Folder; updateFolder refuses parentId === id. Live 2026-10-23 customer
+     * evidence: /api/app/folders/create answers 0 "成功创建目录"; tree readback is
+     * NESTED (children[]), so a caller must flatten recursively.
+     */
+    folderCreate: "/api/api/app/folders/create",
+    folderGet: "/api/api/app/folders/get",
+    folderUpdate: "/api/api/app/folders/update",
+    folderDelete: "/api/api/app/folders/delete",
     appPackagePhysicallyDelete: "/api/api/app/apppackage/physically_delete",
     fieldList: "/api/api/app/bizproperty/list",
     fieldGet: "/api/api/app/bizproperty/get",

package/dist/form-support.js

@@ -719,21 +719,25 @@ export function validateFormButtons(buttons, tool) {
         if (!FORM_BUTTON_LOCATIONS.includes(useLocation))
             throw new ToolRefusalError({ status: "refused", blocker: "form-buttons-invalid", message: `${tool}: buttons[${index}].useLocation 只能是 ${FORM_BUTTON_LOCATIONS.join("|")}（表单工具栏按钮用 FORM）` });
         const bindAction = typeof button.bindAction === "string" ? button.bindAction : "";
+        // `script` is the ergonomic spelling of actionConfig.scriptData (same as
+        // listview.configure); the explicit script wins over a stale config blob.
+        const scriptShorthand = typeof button.script === "string" ? button.script : undefined;
         if (!FORM_BUTTON_BIND_ACTIONS.has(bindAction))
             throw new ToolRefusalError({ status: "refused", blocker: "form-buttons-invalid", message: `${tool}: buttons[${index}].bindAction 必须是 ButtonBindAction 名（SCRIPT/BUSINESS_RULE/FLOW/FORM/ADD_DATA/CUSTOM_PAGE/…）` });
         const operateType = typeof button.operateType === "string" ? button.operateType : "";
         if (!FORM_BUTTON_OPERATE_TYPES.has(operateType))
             throw new ToolRefusalError({ status: "refused", blocker: "form-buttons-invalid", message: `${tool}: buttons[${index}].operateType 必须是 WITH_VIEW 或 WITH_OUT_VIEW` });
+        // Decode once: the SCRIPT guard and the script shorthand both read it.
+        const rawConfig = button.actionConfig;
+        const parsedConfigRaw = typeof rawConfig === "string" ? (() => { try {
+            return JSON.parse(rawConfig);
+        }
+        catch {
+            return undefined;
+        } })() : rawConfig;
+        const config = parsedConfigRaw && typeof parsedConfigRaw === "object" && !Array.isArray(parsedConfigRaw) ? parsedConfigRaw : undefined;
         if (bindAction === "SCRIPT" || bindAction === "BUSINESS_RULE" || bindAction === "FLOW" || bindAction === "ADD_DATA" || bindAction === "FORM") {
-            const actionConfig = button.actionConfig;
-            const record = typeof actionConfig === "string" ? (() => { try {
-                return JSON.parse(actionConfig);
-            }
-            catch {
-                return undefined;
-            } })() : actionConfig;
-            const config = record && typeof record === "object" && !Array.isArray(record) ? record : undefined;
-            if (bindAction === "SCRIPT" && typeof config?.scriptData !== "string")
+            if (bindAction === "SCRIPT" && scriptShorthand === undefined && typeof config?.scriptData !== "string")
                 throw new ToolRefusalError({ status: "refused", blocker: "form-buttons-invalid", message: `${tool}: buttons[${index}] SCRIPT 需要 actionConfig.scriptData（前端脚本源码字符串）` });
             if ((bindAction === "BUSINESS_RULE" || bindAction === "FLOW") && (typeof button.targetCode !== "string" || button.targetCode === ""))
                 throw new ToolRefusalError({ status: "refused", blocker: "form-buttons-invalid", message: `${tool}: buttons[${index}] ${bindAction} 需要 targetCode` });
@@ -745,9 +749,13 @@ export function validateFormButtons(buttons, tool) {
             useLocation,
             bindAction,
             operateType,
-            // The platform stores actionConfig as a string; a caller's object is
-            // serialized once here (double-encoding breaks the renderer).
-            ...(button.actionConfig !== undefined && typeof button.actionConfig !== "string" ? { actionConfig: JSON.stringify(button.actionConfig) } : {}),
+            // actionConfig is a String column: serialize exactly once (double
+            // encoding breaks the renderer). `script` merges into scriptData.
+            ...(scriptShorthand !== undefined
+                ? { actionConfig: JSON.stringify({ ...(config ?? {}), scriptData: scriptShorthand }) }
+                : button.actionConfig !== undefined && typeof button.actionConfig !== "string"
+                    ? { actionConfig: JSON.stringify(button.actionConfig) }
+                    : {}),
             sortKey: typeof button.sortKey === "number" ? button.sortKey : index,
         };
     });
@@ -779,7 +787,8 @@ export function mergeFormOptionsWithButtons(existingOptions, input, tool) {
     const removeCodes = input.removeButtonCodes ?? [];
     if (hasButtons && hasJson)
         throw new ToolRefusalError({ status: "refused", blocker: "form-buttons-ambiguous", message: `${tool}: buttons 与 customButtonJson 只能给一种（buttons 数组更好读；customButtonJson 用于原样透传读回值）` });
-    if (!hasButtons && !hasJson && removeCodes.length === 0)
+    const scriptPatches = input.buttonScripts ?? [];
+    if (!hasButtons && !hasJson && removeCodes.length === 0 && scriptPatches.length === 0)
         return undefined;
     let incoming = [];
     if (hasButtons) {
@@ -802,6 +811,21 @@ export function mergeFormOptionsWithButtons(existingOptions, input, tool) {
     // `replace` restores the whole-list semantics.
     const mode = input.buttonsMode ?? "merge";
     const existing = readFormButtons(options) ?? [];
+    if (scriptPatches.length > 0) {
+        // Patch scriptData on EXISTING buttons only — the write counterpart of
+        // form.get --buttonScripts. An unknown code refuses rather than silently
+        // creating a button with no bindAction.
+        const known = new Set(existing.map((button) => String(button.code ?? "")));
+        const missing = scriptPatches.filter((entry) => !known.has(entry.code)).map((entry) => entry.code);
+        if (missing.length > 0)
+            throw new ToolRefusalError({
+                status: "refused",
+                blocker: "form-button-absent",
+                buttonCodes: missing,
+                available: [...known],
+                message: `${tool}: 表单没有按钮 ${missing.join("、")}（buttonScripts 只改已有按钮的脚本）；可用：${[...known].join("、") || "（无）"}。新建按钮用 buttons + script`,
+            });
+    }
     let final;
     if (mode === "replace") {
         final = incoming;
@@ -812,6 +836,27 @@ export function mergeFormOptionsWithButtons(existingOptions, input, tool) {
             byCode.set(String(button.code), { ...(byCode.get(String(button.code)) ?? {}), ...button });
         for (const code of removeCodes)
             byCode.delete(String(code));
+        for (const patch of scriptPatches) {
+            const current = byCode.get(patch.code);
+            if (!current)
+                continue;
+            let config = {};
+            const rawConfig = current.actionConfig;
+            if (typeof rawConfig === "string" && rawConfig.trim() !== "") {
+                try {
+                    const parsed = JSON.parse(rawConfig);
+                    if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed))
+                        config = parsed;
+                }
+                catch {
+                    config = {};
+                }
+            }
+            else if (rawConfig !== null && typeof rawConfig === "object" && !Array.isArray(rawConfig)) {
+                config = { ...rawConfig };
+            }
+            byCode.set(patch.code, { ...current, actionConfig: JSON.stringify({ ...config, scriptData: patch.script }) });
+        }
         final = [...byCode.values()].map((button, index) => ({ ...button, sortKey: typeof button.sortKey === "number" ? button.sortKey : index }));
     }
     if (removeCodes.length > 0 && mode === "replace")
@@ -1062,7 +1107,7 @@ export async function executeFormDraftWrite(session, args) {
     // turns them into h_biz_button rows (triggerType=FORM). Merge rather than
     // replace so unrelated options (presetButtonManage, sheetPresetButtonManage)
     // survive.
-    const mergedOptions = mergeFormOptionsWithButtons(pre?.options, { buttons: args.buttons, customButtonJson: args.customButtonJson, buttonsMode: args.buttonsMode, removeButtonCodes: args.removeButtonCodes }, "form.draft");
+    const mergedOptions = mergeFormOptionsWithButtons(pre?.options, { buttons: args.buttons, customButtonJson: args.customButtonJson, buttonsMode: args.buttonsMode, removeButtonCodes: args.removeButtonCodes, buttonScripts: args.buttonScripts }, "form.draft");
     const payload = {
         ...(pre ?? {}),
         schemaCode: args.schemaCode,
@@ -1243,7 +1288,8 @@ export async function executeFormPublishWrite(session, args) {
     // drop the buttons (live 2026-10-23).
     const hasButtonDelta = args.buttons !== undefined ||
         args.customButtonJson !== undefined ||
-        (Array.isArray(args.removeButtonCodes) && args.removeButtonCodes.length > 0);
+        (Array.isArray(args.removeButtonCodes) && args.removeButtonCodes.length > 0) ||
+        (Array.isArray(args.buttonScripts) && args.buttonScripts.length > 0);
     const forcePromote = args.force === true || args.rebuild === true || hasButtonDelta;
     if (pre.published === true && !forcePromote)
         return { performed: { skipped: "already-published" }, readback: { published: true } };
@@ -1274,7 +1320,7 @@ export async function executeFormPublishWrite(session, args) {
     // h_biz_button(triggerType=FORM) rows during THIS publish call
     // (ModelManagementFacadeImpl.publishBizForm:1022). Passing them here is the
     // only way to create form buttons without the designer.
-    const mergedOptions = mergeFormOptionsWithButtons(pre.options, { buttons: args.buttons, customButtonJson: args.customButtonJson, buttonsMode: args.buttonsMode, removeButtonCodes: args.removeButtonCodes }, "form.publish");
+    const mergedOptions = mergeFormOptionsWithButtons(pre.options, { buttons: args.buttons, customButtonJson: args.customButtonJson, buttonsMode: args.buttonsMode, removeButtonCodes: args.removeButtonCodes, buttonScripts: args.buttonScripts }, "form.publish");
     const payload = {
         ...pre,
         ...(mergedOptions !== undefined ? { options: mergedOptions } : {}),

package/dist/lanes/folder-contract.js

@@ -0,0 +1,59 @@
+import { CONTRACT_FAMILY, CONTRACT_REFERENCE_VERSION, assertDescriptionCarries, behaviorBinding } from "./contract-support.js";
+/**
+ * App-tree folder (目录/分组) wire contract — issue
+ * 2026-10-23-omc-app-folder-create-and-move. Source: AppFunctionController
+ * (/api/app/folders, 8.6.26 :90-260) and
+ * ApplicationFacadeImpl.createFolder/updateFolder/deleteFolder (:586-640).
+ */
+export const FOLDER_WIRE = Object.freeze({
+    endpoints: Object.freeze({
+        create: "POST /api/api/app/folders/create  body {appCode,name[,name_i18n,parentId,code,icon]}",
+        get: "GET /api/api/app/folders/get?folderId=",
+        update: "POST /api/api/app/folders/update  body {id,name[,name_i18n,parentId]}",
+        delete: "POST /api/api/app/folders/delete?folderId=",
+    }),
+    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",
+});
+export const FOLDER_LANE_CONTRACT = Object.freeze({
+    lane: "app-tree-folders",
+    family: CONTRACT_FAMILY,
+    referenceVersion: CONTRACT_REFERENCE_VERSION,
+    endpoints: Object.freeze({
+        tree: "apppackage/trees",
+        create: "folders/create",
+        get: "folders/get",
+        update: "folders/update",
+        delete: "folders/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)]),
+        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([
+        "cp-sources/backend/decompiled-full/launcher-8.6.26/cloudpivot-engine-8.6.26/com/authine/cloudpivot/web/api/controller/app/AppFunctionController.java",
+        "cp-sources/backend/decompiled-full/launcher-8.6.26/cloudpivot-metadata-8.6.26/com/authine/cloudpivot/metadata/history/apppackage/service/ApplicationFacadeImpl.java",
+        "issue/2026-10-23-omc-app-folder-create-and-move.md",
+    ]),
+    tools: Object.freeze({
+        "folder.tree": Object.freeze({ scope: "app-tree folder/model tree (flattened with path/depth)", description: "读应用树（目录/分组 + 模型）：平台 apppackage/trees 返回嵌套 children，本工具递归展平并给每节点 path/depth" }),
+        "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）" }),
+    }),
+});
+export function assertFolderContract() {
+    assertDescriptionCarries(FOLDER_LANE_CONTRACT, "folder.tree", ["children", "path", "depth"]);
+    assertDescriptionCarries(FOLDER_LANE_CONTRACT, "folder.create", ["parentId", "顶层", "folder-duplicate"]);
+    assertDescriptionCarries(FOLDER_LANE_CONTRACT, "folder.update", ["parentId", "model.move"]);
+    assertDescriptionCarries(FOLDER_LANE_CONTRACT, "folder.delete", ["非递归", "folder-not-empty"]);
+    if (!FOLDER_WIRE.defaults.includes("DIRECTORY_NOT_EMPTY"))
+        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");
+}
+//# sourceMappingURL=folder-contract.js.map

package/dist/lanes/folder-coverage.js

@@ -0,0 +1,16 @@
+import { claim, declareLaneCoverage } from "./coverage-declaration.js";
+import { FOLDER_LANE_CONTRACT } from "./folder-contract.js";
+const T = FOLDER_LANE_CONTRACT.tools;
+export const FOLDER_COVERAGE = declareLaneCoverage(FOLDER_LANE_CONTRACT.lane, [
+    {
+        capability: "App-tree folders (目录/分组): read flattened tree, create, rename/move, non-recursive delete",
+        evidence: ["issue/2026-10-23-omc-app-folder-create-and-move.md", "packages/omc-cli/src/lanes/folder.ts"],
+        tools: [
+            claim("folder.tree", T["folder.tree"].scope),
+            claim("folder.create", T["folder.create"].scope),
+            claim("folder.update", T["folder.update"].scope),
+            claim("folder.delete", T["folder.delete"].scope),
+        ],
+    },
+]);
+//# sourceMappingURL=folder-coverage.js.map

package/dist/lanes/folder.js

@@ -0,0 +1,241 @@
+import { z } from "zod";
+import { ToolRefusalError, defineTool } from "../tool-types.js";
+import { governedRead } from "../read.js";
+import { writeTool } from "../write.js";
+import { wireCall, wireRows } 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";
+/**
+ * App-tree folders (目录/分组) and model reparenting.
+ *
+ * issue 2026-10-23-omc-app-folder-create-and-move: a customer had to build 8
+ * folders and move 33 models by hand (or with a raw HAR-replayed script) because
+ * OMC could only attach a NEW model to an EXISTING folder at create time.
+ *
+ * Wire facts (decompiled 8.6.26 AppFunctionController :90-260 +
+ * ApplicationFacadeImpl.createFolder/updateFolder/deleteFolder :586-640, and the
+ * customer's HAR replay which answered 0「成功创建目录」):
+ *  - POST /api/app/folders/create  {appCode, name, name_i18n?, parentId?, code?, icon?}
+ *    createFolder forces type=Folder and defaults parentId to the app package id
+ *    (root) — so an omitted parentId creates a TOP-LEVEL folder, not a child.
+ *  - POST /api/app/folders/update  {id, name, name_i18n?, parentId?}
+ *    refuses parentId === id (FOLDER_PARENTID_EQUALS_ID); parentId is only
+ *    written when non-empty (omitted keeps the current parent).
+ *  - POST /api/app/folders/delete  ?folderId=  refuses a non-empty folder
+ *    (DIRECTORY_NOT_EMPTY) — it is NOT a recursive delete.
+ *  - GET  /api/app/folders/get     ?folderId=
+ *  - The tree face (apppackage/trees?appCode=) is NESTED: folders carry their
+ *    children in `children[]`. Reading only the top-level array reports "folder
+ *    created but not found" (the customer's first failure) — this lane flattens
+ *    recursively and reports each node's depth/path.
+ *
+ * Moving a MODEL is the same bizmodels/update call model.update already makes,
+ * with the target folder as parentId — exposed as `model.move` so it has its own
+ * intent, dry-run preview, and readback.
+ */
+const LANE = LANES.folder;
+const T = FOLDER_LANE_CONTRACT.tools;
+/** Flatten the nested app tree, keeping the path so a caller can tell WHICH "合同" it means. */
+/**
+ * Flatten the nested app tree. Live 1.1.25 readback: `apppackage/trees?appCode=`
+ * returns the TOP-LEVEL folders directly (no app-package container row), each
+ * carrying its children — so a top-level folder is depth 0 and a child is
+ * "父 / 子" at depth 1. Reading only the top array makes a freshly created child
+ * folder look absent (the customer's first failure).
+ */
+function flattenFolders(rows, parentPath = []) {
+    const out = [];
+    for (const raw of rows) {
+        if (raw === null || typeof raw !== "object")
+            continue;
+        const node = raw;
+        const name = String(node.name ?? node.code ?? "");
+        const path = [...parentPath, name];
+        out.push({
+            id: node.id ?? null,
+            type: node.type ?? null,
+            code: node.code ?? null,
+            name: node.name ?? null,
+            parentId: node.parentId ?? null,
+            depth: path.length - 1,
+            path: path.join(" / "),
+        });
+        if (Array.isArray(node.children) && node.children.length > 0)
+            out.push(...flattenFolders(node.children, path));
+    }
+    return out;
+}
+async function readTree(session, appCode) {
+    return flattenFolders(wireRows((await wireCall(session, { path: ENDPOINTS.applicationTree, query: { appCode } })).data));
+}
+function folderRefusal(schemaCode, message, extra = {}) {
+    throw new ToolRefusalError({ status: "refused", blocker: "folder-not-found", ...(schemaCode ? { applicationCode: schemaCode } : {}), ...extra, message });
+}
+/**
+ * Resolve a folder by id, code, or by full path ("合同管理 / 归档"). A bare name
+ * that matches several folders is ambiguous — name them with their paths instead
+ * of guessing (the customer's 8 folders included duplicates by design).
+ */
+function resolveFolder(rows, ref) {
+    const byId = rows.find((row) => String(row.id ?? "") === ref);
+    if (byId)
+        return byId;
+    const byCode = rows.filter((row) => String(row.code ?? "") === ref);
+    if (byCode.length === 1)
+        return byCode[0];
+    if (byCode.length > 1)
+        folderRefusal(undefined, `目录 code「${ref}」不唯一（${byCode.length} 个）——改用 id 或完整 path：${byCode.map((row) => String(row.path)).join("、")}`);
+    const byPath = rows.filter((row) => String(row.path ?? "") === ref);
+    if (byPath.length === 1)
+        return byPath[0];
+    const byName = rows.filter((row) => String(row.name ?? "") === ref);
+    if (byName.length === 1)
+        return byName[0];
+    if (byName.length > 1)
+        folderRefusal(undefined, `目录名「${ref}」不唯一（${byName.length} 个）——用完整 path 指定：${byName.map((row) => String(row.path)).join("、")}`);
+    folderRefusal(undefined, `找不到目录「${ref}」——先 folder.tree 看 id/path；注意 create 省略 parentId 建的是顶层目录`, {
+        available: rows.filter((row) => row.type === "Folder").map((row) => ({ id: row.id, path: row.path })).slice(0, 40),
+    });
+}
+function folderTools(tools) {
+    tools.push(defineTool({
+        name: "folder.tree",
+        layer: "low",
+        kind: "read",
+        lane: LANE,
+        scope: T["folder.tree"].scope,
+        description: "读取应用树（目录/分组 + 模型节点），**递归展平**并给出每个节点的 `path` 与 `depth`（平台 `apppackage/trees?appCode=` 返回的是嵌套 children，只看顶层会误判“目录没建成”——issue 2026-10-23 的真实失败）。`foldersOnly:true` 只回目录（type=Folder）。目录的 id 就是 folder.update/delete 与 model.move 的 `folderId/parentId`。",
+        inputSchema: {
+            environment: environmentArg,
+            applicationCode: z.string().optional().describe("应用 code；省略用配置默认应用"),
+            foldersOnly: z.boolean().optional().describe("只回目录节点（type=Folder）"),
+            capability: capabilityArg,
+        },
+        handler: async (ctx, args, self) => governedRead(ctx, self, args, async (session) => {
+            const appCode = await resolveApplicationCode(session, args.applicationCode);
+            const rows = await readTree(session, appCode);
+            const nodes = args.foldersOnly === true ? rows.filter((row) => row.type === "Folder") : rows;
+            return {
+                applicationCode: appCode,
+                nodeCount: nodes.length,
+                folderCount: rows.filter((row) => row.type === "Folder").length,
+                modelCount: rows.filter((row) => row.type === "BizModel").length,
+                nodes,
+                note: "type=Folder 是目录/分组；parentId 指向父目录（顶层目录的 parentId = 应用包 id）。嵌套 children 已展平，path 用「 / 」连接。",
+            };
+        }),
+    }));
+    writeTool(tools, "folder.create", LANE, T["folder.create"].scope, "新建应用目录（分组）：`POST /api/app/folders/create`（AppFunctionController:105；`ApplicationFacadeImpl.createFolder:586` 强制 `type=Folder`，**省略 `parentId` 会挂到应用根**，即顶层目录）。给 `parentId` 才是子目录。写入后按 `path` 回读确认（树是嵌套的）。同名不等于重复：平台不校验重名，工具默认按「同父目录下同名」拒绝（`folder-duplicate`），要并列同名传 `allowDuplicate:true`。", {
+        applicationCode: z.string().optional().describe("应用 code；省略用配置默认应用"),
+        name: z.string().min(1).describe("目录显示名（平台校验非空、中文长度 ≤50）"),
+        parentId: z.string().optional().describe("父目录 id；**省略=应用根（顶层目录）**。子目录必须显式给，值来自 folder.tree 的 id"),
+        code: z.string().optional().describe("目录 code（可选；平台只校验 code 唯一，空则自动生成）"),
+        name_i18n: z.string().optional().describe("多语言名（JSON 字符串，如 {\"zh-CN\":\"合同\",\"en\":\"Contract\"}）"),
+        allowDuplicate: z.boolean().optional().describe("允许同父目录下同名（默认拒绝，避免建出两个同名目录后无法用 path 定位）"),
+    }, async (session, args) => {
+        const appCode = await resolveApplicationCode(session, args.applicationCode);
+        const before = await readTree(session, appCode);
+        if (args.allowDuplicate !== true) {
+            const siblings = before.filter((row) => String(row.parentId ?? "") === String(args.parentId ?? "") || (args.parentId === undefined && row.depth === 0));
+            if (siblings.some((row) => row.type === "Folder" && String(row.name ?? "") === args.name))
+                throw new ToolRefusalError({
+                    status: "refused",
+                    blocker: "folder-duplicate",
+                    applicationCode: appCode,
+                    path: `${args.parentId ?? "(root)"} / ${args.name}`,
+                    message: `同一层级已有同名目录「${args.name}」——平台允许重名，但重名后 folder.tree 的 path 无法唯一定位；确认要并列同名再传 allowDuplicate:true`,
+                });
+        }
+        const performed = await wireCall(session, {
+            path: ENDPOINTS.folderCreate,
+            method: "POST",
+            body: {
+                appCode,
+                name: args.name,
+                ...(args.parentId !== undefined ? { parentId: args.parentId } : {}),
+                ...(args.code !== undefined ? { code: args.code } : {}),
+                ...(args.name_i18n !== undefined ? { name_i18n: args.name_i18n } : {}),
+            },
+        });
+        const after = await readTree(session, appCode);
+        const created = after.filter((row) => row.type === "Folder" && String(row.name ?? "") === args.name && !before.some((old) => old.id === row.id));
+        return {
+            performed: { errcode: performed.errcode },
+            readback: {
+                applicationCode: appCode,
+                present: created.length > 0,
+                created: created.map((row) => ({ id: row.id, path: row.path, parentId: row.parentId })),
+                folderCount: after.filter((row) => row.type === "Folder").length,
+                ...(after.filter((row) => row.type === "Folder" && String(row.name ?? "") === args.name && String(row.parentId ?? "") === String(created[0]?.parentId ?? ""))
+                    .length > 1
+                    ? { warning: "同层级出现了多个同名目录（allowDuplicate 生效或既有同名）；后续用 id 定位，不要用 path/name" }
+                    : {}),
+                hint: created.length > 0 ? "把模型放进该目录用 model.move（parentId = 这里的 id）" : "回读未见新目录：树是嵌套的，但 folder.tree 已递归展平；若确实没有，检查应用 code",
+            },
+        };
+    });
+    writeTool(tools, "folder.update", LANE, T["folder.update"].scope, "重命名目录或把目录挂到另一个目录下：`POST /api/app/folders/update`（AppFunctionController:219；`updateFolder:612` 拒绝 `parentId === id`，`parentId` 为空时保留原父级）。**只改目录节点本身，不会移动目录里的模型**——模型移动用 `model.move`。", {
+        applicationCode: z.string().optional(),
+        folderId: z.string().min(1).describe("目录 id（folder.tree 的 id）"),
+        name: z.string().min(1).optional().describe("新显示名"),
+        name_i18n: z.string().optional(),
+        parentId: z.string().min(1).optional().describe("新父目录 id（挂到根用应用包 id；不理解根 id 就省略此字段表示不改父级）"),
+    }, async (session, args) => {
+        const appCode = await resolveApplicationCode(session, args.applicationCode);
+        const before = await readTree(session, appCode);
+        const current = resolveFolder(before, args.folderId);
+        if (args.name === undefined && args.parentId === undefined)
+            throw new ToolRefusalError({ status: "refused", blocker: "folder-update-empty-patch", message: "没有可应用的补丁——至少给 name 或 parentId" });
+        if (args.parentId !== undefined && args.parentId === args.folderId)
+            throw new ToolRefusalError({ status: "refused", blocker: "folder-parent-self", message: "parentId 不能等于目录自身（平台 FOLDER_PARENTID_EQUALS_ID）" });
+        const performed = await wireCall(session, {
+            path: ENDPOINTS.folderUpdate,
+            method: "POST",
+            body: { id: args.folderId, name: args.name ?? current.name, ...(args.name_i18n !== undefined ? { name_i18n: args.name_i18n } : {}), ...(args.parentId !== undefined ? { parentId: args.parentId } : {}) },
+        });
+        const after = await readTree(session, appCode);
+        const now = after.find((row) => String(row.id ?? "") === args.folderId);
+        return {
+            performed: { errcode: performed.errcode },
+            readback: {
+                folderId: args.folderId,
+                present: now !== undefined,
+                before: { name: current.name, parentId: current.parentId, path: current.path },
+                after: now ? { name: now.name, parentId: now.parentId, path: now.path } : null,
+                note: "只改了目录节点；目录内的模型不随目录移动（模型要动请用 model.move）",
+            },
+        };
+    });
+    writeTool(tools, "folder.delete", LANE, T["folder.delete"].scope, "删除空目录：`POST /api/app/folders/delete?folderId=`（AppFunctionController:246）。**非递归**——目录里还有子目录或模型时平台回 `DIRECTORY_NOT_EMPTY`，工具在写前先查子节点并拒绝（`folder-not-empty`），避免半删。要清空请先 `model.move` 移走模型、删子目录。", {
+        applicationCode: z.string().optional(),
+        folderId: z.string().min(1),
+    }, async (session, args) => {
+        const appCode = await resolveApplicationCode(session, args.applicationCode);
+        const before = await readTree(session, appCode);
+        const current = resolveFolder(before, args.folderId);
+        if (String(current.type ?? "") !== "Folder")
+            throw new ToolRefusalError({ status: "refused", blocker: "folder-target-not-folder", message: `${args.folderId} 不是目录节点（type=${String(current.type)}）；删模型用 model.delete` });
+        const children = before.filter((row) => String(row.parentId ?? "") === String(args.folderId));
+        if (children.length > 0)
+            throw new ToolRefusalError({
+                status: "refused",
+                blocker: "folder-not-empty",
+                folderId: args.folderId,
+                children: children.map((row) => ({ id: row.id, type: row.type, path: row.path })).slice(0, 40),
+                message: `目录「${current.path}」还有 ${children.length} 个子节点——平台非递归删除会回 DIRECTORY_NOT_EMPTY。先 model.move 移走模型 / 删子目录`,
+            });
+        const performed = await wireCall(session, { path: ENDPOINTS.folderDelete, method: "POST", query: { folderId: args.folderId } });
+        const after = await readTree(session, appCode);
+        return {
+            performed: { errcode: performed.errcode },
+            readback: { folderId: args.folderId, deleted: !after.some((row) => String(row.id ?? "") === args.folderId), path: current.path },
+        };
+    });
+}
+export function registerFolderLane(tools) {
+    folderTools(tools);
+}
+//# sourceMappingURL=folder.js.map

package/dist/lanes/form.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { ENDPOINTS } from "../endpoints.js";
+import { decodeButtonScript } from "./list-view.js";
 import { executeFormDraftWrite, executeFormPublishWrite, executeFormRunButtonWrite, readFormButtons, readFormOrNull, refuseEmptyCallerLayout, validateHtmlRender } from "../form-support.js";
 import { capabilityArg, environmentArg } from "../args.js";
 import { governedRead } from "../read.js";
@@ -51,6 +52,7 @@ export function registerFormLane(tools) {
                 .optional()
                 .describe("控件定义投影：true = 返回全部控件的 draft/published 定义；字符串数组 = 只返回这些控件码的定义；省略 = 只回控件码清单"),
             full: z.boolean().optional().describe("返回全部六份布局 JSON 原文（大体积）"),
+            buttonScripts: z.boolean().optional().describe("附带表单按钮的脚本原文（options.customButtonJson 里 SCRIPT 按钮的 actionConfig.scriptData）及 sha/字节数"),
             capability: capabilityArg,
         },
         handler: async (ctx, args, self) => governedRead(ctx, self, args, async (session) => {
@@ -120,18 +122,21 @@ export function registerFormLane(tools) {
             // Form buttons are tiny; list them plainly in the COMPACT face so a
             // readback never needs the artifact just to see which buttons exist.
             const formButtons = readFormButtons(sheet.options) ?? [];
+            const withScripts = args.buttonScripts === true;
             return {
                 ...base,
                 ...(formButtons.length > 0
                     ? {
                         formButtonCodes: formButtons.map((button) => String(button.code ?? "")),
-                        formButtons: formButtons.map((button) => ({
-                            code: button.code ?? null,
-                            name: button.name ?? null,
-                            bindAction: button.bindAction ?? null,
-                            targetCode: button.targetCode ?? null,
-                            useLocation: button.useLocation ?? null,
-                        })),
+                        formButtons: formButtons.map((button) => withScripts
+                            ? decodeButtonScript(button)
+                            : {
+                                code: button.code ?? null,
+                                name: button.name ?? null,
+                                bindAction: button.bindAction ?? null,
+                                targetCode: button.targetCode ?? null,
+                                useLocation: button.useLocation ?? null,
+                            }),
                     }
                     : {}),
                 draftControlCodes: draftControls,
@@ -157,6 +162,7 @@ export function registerFormLane(tools) {
         customButtonJson: z.string().optional().describe("buttons 的原样 JSON 数组字符串（与 buttons 互斥；用于把 form.get 读回值直接回写）"),
         buttonsMode: z.enum(["merge", "replace"]).optional().describe("默认 merge：按 code 增量 upsert（改一个按钮不必重发全表）；replace：整表替换"),
         removeButtonCodes: z.array(z.string().min(1)).optional().describe("要删除的按钮 code（仅 merge 模式）"),
+        buttonScripts: z.array(z.object({ code: z.string().min(1), script: z.string() })).optional().describe("直接改已有表单按钮的脚本（actionConfig.scriptData），按 code 逐字替换；未知 code 拒绝。不必重发整表"),
     }, async (session, args) => executeFormDraftWrite(session, { ...args, sheetCode: resolveSheetCode(args.schemaCode, args.sheetCode) }), (args) => {
         // Zero-wire refusal (ticket 74): fires in semanticGate BEFORE the
         // governed pipeline — including the rollback before-capture read.
@@ -192,6 +198,7 @@ export function registerFormLane(tools) {
         customButtonJson: z.string().optional().describe("buttons 的原样 JSON 数组字符串（与 buttons 互斥）"),
         buttonsMode: z.enum(["merge", "replace"]).optional().describe("默认 merge：按 code 增量 upsert；replace：整表替换"),
         removeButtonCodes: z.array(z.string().min(1)).optional().describe("要删除的按钮 code（仅 merge 模式）"),
+        buttonScripts: z.array(z.object({ code: z.string().min(1), script: z.string() })).optional().describe("直接改已有表单按钮的脚本（actionConfig.scriptData），按 code 逐字替换；未知 code 拒绝。不必重发整表"),
     }, async (session, args) => executeFormPublishWrite(session, { ...args, sheetCode: resolveSheetCode(args.schemaCode, args.sheetCode) }));
     registerPackageTool(tools, {
         name: "configure_form",

package/dist/lanes/lane-ids.js

@@ -13,6 +13,7 @@ export const LANES = Object.freeze({
     meta: "meta-governance",
     environment: "environment-governance",
     app: "app-management",
+    folder: "app-tree-folders",
     dictionary: "dictionary-management",
     model: "model-management",
     field: "field-families",

package/dist/lanes/list-view-contract.js

@@ -167,6 +167,9 @@ export function assertListViewContract() {
     if (!LIST_VIEW_WIRE.deleteBody.includes("query/delete"))
         throw new Error("list-view contract must pin the delete endpoint");
     assertDescriptionCarries(LIST_VIEW_LANE_CONTRACT, "listview.create", ["query/create", "LIST", "get_header"]);
+    // Button scripts are stored in h_biz_button.actionConfig.scriptData (a JSON
+    // STRING); listview.get/--buttons and form.get/--buttonScripts surface them
+    // without a round trip through the artifact.
     assertDescriptionCarries(LIST_VIEW_LANE_CONTRACT, "listview.get", ["query/get", "code", "默认视图", "present"]);
     assertDescriptionCarries(LIST_VIEW_LANE_CONTRACT, "listview.list", ["query/list", "code"]);
     assertDescriptionCarries(LIST_VIEW_LANE_CONTRACT, "listview.configure", ["query/update", "fieldCodes", "默认视图", "querySorts", "queryConditions", "queryActions", "queryActionType", "associationType", "options", "queryPresentation", "htmlJson", "schemaRelations", "customButtons", "customButtonJson", "bindAction", "useLocation", "operateType", "showPermType", "QUERY", "pagingSetting", "listViewModeSetting", "presentationType", "queryGanttModel", "GANTT", "queryLayer", "multiTableHeaderConfig", "publish=TRUE", "field.publish", "rule.enable", "actionConfig", "targetModel", "listview-button-target-unresolved"]);

package/dist/lanes/list-view-shapes.js

@@ -232,6 +232,10 @@ export const listViewButtonArg = z
         .union([z.string(), z.record(z.string(), z.unknown())])
         .optional()
         .describe("BizButtonModel.actionConfig 原样透传（与 targetModel/targetForm/configureList 互斥）；ADD_DATA/FORM 只接受 schemaCodeVal/formListData/configureList 子形状"),
+    script: z
+        .string()
+        .optional()
+        .describe("SCRIPT 按钮的脚本源码简写——等价于 actionConfig.scriptData；与 actionConfig 同传时以 script 为准（写进 actionConfig.scriptData）"),
 })
     .describe("customButtons[] entry (BizButtonModel); name/code/useLocation/bindAction/operateType are required; triggerType/triggerCode are forced to QUERY/view code and sortKey to the array position");
 /**
@@ -1004,7 +1008,29 @@ export function normalizeButtons(buttons, schemaCode, triggerCode) {
         // ("undefined is not iterable") blank the click. Emit an empty
         // configureList for those three bind actions and `{}` otherwise.
         const needsConfigureList = button.bindAction === "FLOW" || button.bindAction === "ADD_DATA" || button.bindAction === "FORM";
-        row.actionConfig = encodeJsonColumn(button.actionConfig ?? (needsConfigureList ? { configureList: [] } : {}));
+        // `script` is the ergonomic spelling of actionConfig.scriptData for SCRIPT
+        // buttons; when both are given the explicit script wins (it is the value the
+        // caller just wrote, not a stale config blob).
+        let actionConfig = button.actionConfig ?? (needsConfigureList ? { configureList: [] } : undefined);
+        if (button.script !== undefined) {
+            let base = {};
+            if (actionConfig !== undefined) {
+                if (typeof actionConfig === "string") {
+                    try {
+                        const parsed = JSON.parse(actionConfig);
+                        if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed))
+                            base = parsed;
+                    }
+                    catch {
+                        base = {};
+                    }
+                }
+                else
+                    base = { ...actionConfig };
+            }
+            actionConfig = { ...base, scriptData: button.script };
+        }
+        row.actionConfig = encodeJsonColumn(actionConfig ?? {});
         return row;
     });
 }

package/dist/lanes/list-view.js

@@ -1,3 +1,4 @@
+import { createHash } from "node:crypto";
 import { z } from "zod";
 import { ENDPOINTS } from "../endpoints.js";
 import { capabilityArg, environmentArg } from "../args.js";
@@ -195,6 +196,50 @@ export function filterDefaultSystemColumns(columns, hideDefaultSystemFields) {
         return [...columns];
     return columns.filter((column) => typeof column.propertyCode !== "string" || !SYSTEM_FIELD_CODES.has(column.propertyCode));
 }
+/**
+ * Decode a BizButtonModel row's `actionConfig` (stored as a JSON STRING) and
+ * pull out the script source. Everything else is passed through so the caller
+ * can see bindAction/targetCode without a second read.
+ */
+export function decodeButtonScript(input) {
+    const button = (input ?? {});
+    const rawConfig = button.actionConfig;
+    let parsed;
+    if (typeof rawConfig === "string" && rawConfig.trim() !== "") {
+        try {
+            const value = JSON.parse(rawConfig);
+            if (value !== null && typeof value === "object" && !Array.isArray(value))
+                parsed = value;
+        }
+        catch {
+            parsed = undefined;
+        }
+    }
+    else if (rawConfig !== null && typeof rawConfig === "object" && !Array.isArray(rawConfig)) {
+        parsed = rawConfig;
+    }
+    const script = typeof parsed?.scriptData === "string" ? parsed.scriptData : undefined;
+    return {
+        code: button.code ?? null,
+        name: button.name ?? null,
+        useLocation: button.useLocation ?? null,
+        bindAction: button.bindAction ?? null,
+        operateType: button.operateType ?? null,
+        targetCode: button.targetCode ?? null,
+        ...(script !== undefined
+            ? {
+                scriptData: script,
+                scriptBytes: Buffer.byteLength(script, "utf8"),
+                scriptSha256: createHash("sha256").update(script, "utf8").digest("hex"),
+            }
+            : {
+                scriptAbsent: typeof rawConfig === "string" && rawConfig.trim() !== "" && parsed === undefined
+                    ? "actionConfig 不是合法 JSON"
+                    : "该按钮没有 scriptData（非 SCRIPT 按钮，或脚本未配置）",
+            }),
+        ...(parsed !== undefined ? { actionConfig: parsed } : {}),
+    };
+}
 export function registerListViewLane(tools) {
     tools.push(defineTool({
         name: "listview.get",
@@ -208,6 +253,8 @@ export function registerListViewLane(tools) {
             schemaCode: z.string().min(1),
             code: z.string().optional().describe("视图 code；省略时用默认视图（=schemaCode）"),
             full: z.boolean().optional().describe("返回 query/get 原始报文（大体积）；默认返回列/排序/条件/动作/按钮的紧凑清单"),
+            buttons: z.boolean().optional().describe("附带按钮明细（code/name/useLocation/bindAction/targetCode + SCRIPT 按钮的 scriptData 原文、actionConfig 解析结果）。按钮脚本存在 h_biz_button.actionConfig.scriptData，不必再翻 artifact"),
+            buttonCode: z.string().min(1).optional().describe("只返回这一个按钮的脚本（与 buttons 同效但更省输出）；不存在时报 button-absent 并列出可用 code"),
             capability: capabilityArg,
         },
         handler: async (ctx, args, self) => governedRead(ctx, self, args, async (session) => {
@@ -255,6 +302,27 @@ export function registerListViewLane(tools) {
                 conditions,
                 actionCodes: readArray(model, "queryActions").map((action) => action.actionCode).filter((value) => value !== undefined),
                 buttonCount: readArray(model, "customButtons").length,
+                // 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 →
+                // JSON.parse" chain for a plain script inspection.
+                ...(() => {
+                    if (args.buttons !== true && args.buttonCode === undefined)
+                        return {};
+                    const rows = readArray(model, "customButtons");
+                    const decoded = rows.map((button) => decodeButtonScript(button));
+                    if (args.buttonCode !== undefined) {
+                        const hit = decoded.find((button) => button.code === args.buttonCode);
+                        if (!hit)
+                            return {
+                                buttonAbsent: args.buttonCode,
+                                availableButtonCodes: decoded.map((button) => button.code),
+                                buttonHint: `视图 ${code} 没有按钮 ${args.buttonCode}；可用：${decoded.map((button) => button.code).join("、") || "（无）"}`,
+                            };
+                        return { button: hit };
+                    }
+                    return { buttons: decoded };
+                })(),
                 options: model.options !== undefined && model.options !== null ? parseConditionOptions(model.options) : null,
                 // Round 16 (bench65 feedback): the query row's `published=false` is NOT
                 // an "inactive view" signal — a list view has no draft/publish
@@ -264,6 +332,10 @@ export function registerListViewLane(tools) {
             };
         }),
     }));
+    /**
+     * Decode a BizButtonModel row's `actionConfig` (stored as a JSON STRING) and
+     * pull out the script source. Everything else is passed through so the caller
+    
     /** Reverse enum map: the wire stores numeric queryActionType, the tool arg takes the enum name. */
     const QUERY_ACTION_TYPE_NAME = new Map(Object.entries(QUERY_ACTION_TYPE.index).map(([name, index]) => [index, name]));
     /**
@@ -402,6 +474,10 @@ export function registerListViewLane(tools) {
             .array(listViewButtonArg)
             .optional()
             .describe("customButtons; sent as the customButtonJson JSON array string; omitted leaves the existing buttons untouched, provided replaces every button under the QUERY trigger (schema + child tables)"),
+        buttonScripts: z
+            .array(z.object({ code: z.string().min(1), script: z.string() }))
+            .optional()
+            .describe("直接改按钮脚本：按 code 把 actionConfig.scriptData 换成 script（不改其它按钮/字段）。内部读回现有按钮再回写，因此不必先 listview.get 再整表重发；与 buttons 互斥"),
         options: listViewOptionsArg.optional(),
         presentationType: presentationTypeArg.optional(),
         gantt: listViewGanttArg.optional(),
@@ -513,7 +589,50 @@ export function registerListViewLane(tools) {
         // expanded into the authoritative actionConfig shape from readback
         // BEFORE normalizeButtons (targetCode/targetObjCode never emitted for
         // ADD_DATA/FORM — measured ineffective, see dry-lint).
-        if (args.buttons !== undefined) {
+        if (args.buttons !== undefined && args.buttonScripts !== undefined)
+            throw new ToolRefusalError({ status: "refused", blocker: "listview-buttons-ambiguous", message: "buttons 与 buttonScripts 互斥：整表重配用 buttons，只改脚本用 buttonScripts" });
+        if (args.buttonScripts !== undefined) {
+            // Patch ONE field of ONE button in place: read the stored rows, rewrite
+            // actionConfig.scriptData by code, and send the full list back. This is
+            // the write counterpart of `listview.get --buttons`.
+            const existing = readArray(model, "customButtons");
+            if (existing.length === 0)
+                throw new ToolRefusalError({ status: "refused", blocker: "listview-button-absent", schemaCode: args.schemaCode, message: `视图 ${code} 没有自定义按钮——先用 listview.configure 的 buttons 建按钮（bindAction:SCRIPT）` });
+            const byCode = new Map(existing.map((button) => [String(button.code ?? ""), button]));
+            const missing = args.buttonScripts.map((entry) => entry.code).filter((buttonCode) => !byCode.has(buttonCode));
+            if (missing.length > 0)
+                throw new ToolRefusalError({
+                    status: "refused",
+                    blocker: "listview-button-absent",
+                    schemaCode: args.schemaCode,
+                    buttonCodes: missing,
+                    available: existing.map((button) => String(button.code ?? "")),
+                    message: `视图 ${code} 没有按钮 ${missing.join("、")}；可用：${existing.map((button) => String(button.code ?? "")).join("、")}`,
+                });
+            const patched = existing.map((button) => {
+                const entry = args.buttonScripts.find((candidate) => candidate.code === String(button.code ?? ""));
+                if (!entry)
+                    return button;
+                const rawConfig = button.actionConfig;
+                let config = {};
+                if (typeof rawConfig === "string" && rawConfig.trim() !== "") {
+                    try {
+                        const parsed = JSON.parse(rawConfig);
+                        if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed))
+                            config = parsed;
+                    }
+                    catch {
+                        config = {};
+                    }
+                }
+                else if (rawConfig !== null && typeof rawConfig === "object" && !Array.isArray(rawConfig)) {
+                    config = { ...rawConfig };
+                }
+                return { ...button, actionConfig: encodeJsonColumn({ ...config, scriptData: entry.script }) };
+            });
+            body.customButtonJson = JSON.stringify(normalizeButtons(patched, args.schemaCode, code));
+        }
+        else if (args.buttons !== undefined) {
             const expandedButtons = await expandButtonActionConfigs(session, args.schemaCode, args.buttons);
             body.customButtonJson = JSON.stringify(normalizeButtons(expandedButtons, args.schemaCode, code));
         }
@@ -628,6 +747,12 @@ export function registerListViewLane(tools) {
             readback.buttons = buttons
                 .map(decodeButtonRow)
                 .sort((a, b) => Number(a.sortKey ?? 0) - Number(b.sortKey ?? 0));
+            if (args.buttonScripts !== undefined) {
+                const decoded = buttons.map((button) => decodeButtonScript(button));
+                readback.buttonScripts = decoded
+                    .filter((button) => (args.buttonScripts ?? []).some((entry) => entry.code === button.code))
+                    .map((button) => ({ code: button.code, bindAction: button.bindAction, scriptBytes: button.scriptBytes ?? 0, scriptSha256: button.scriptSha256 ?? null, scriptData: button.scriptData ?? null }));
+            }
             readback.buttonsRenderCompat = buttonsRenderCompat(buttons);
         }
         if (afterModel.options !== undefined && afterModel.options !== null) {

package/dist/lanes/model-contract.js

@@ -126,6 +126,10 @@ export const MODEL_LANE_CONTRACT = Object.freeze({
             scope: MODEL_SCOPE,
             description: "Set the model's data title / 数据标题 (POST bizmodels/update_summary {schemaCode, summary}) — the fallback display of relation fields and the portal list title. The platform stores `Summary[]` JSON and runtime resolution runs JsonUtility.toList(summaryExpression, Summary.class) (BizObjectTitleSetter :140-160); Summary is {int isDataItem (1=表单字段, 2=查询字段), String code, String param}. The tool normalizes: canonical Summary[] JSON is validated/re-serialized, a PURE {field} placeholder template is converted to [{isDataItem:1,code}], and anything else (literal text, malformed JSON) refuses `model-summary-invalid` — a raw template stored verbatim poisoned the model so ALL later data.save/data.submit answered a bare 50000 (live-verified). Readback is the sibling GET bizmodels/get_summary face; it warns when the STORED value is not a valid Summary[]. Empty summary refuses `model-summary-empty`; a missing schema answers 300014 数据模型未发布.",
         }),
+        "model.move": Object.freeze({
+            scope: "move a model's app-tree node to another folder (bizmodels/update parentId)",
+            description: "把模型移动到指定应用目录（分组）：复用 `POST bizmodels/update`，只把 `parentId` 换成目标目录节点 id（AppFunctionController 补丁语义：bizSchemaCode/id/name/parentId 全量必填，工具从应用树解析）。`folderId` 必须是 `folder.tree` 里 type=Folder 的 **id**，给目录名会 `folder-not-found` 并列出可用目录。移动只改菜单节点归属：schema/字段/表单/视图/发布状态不动。回读用应用树按 `parentId` 核对（`moved:true`）。",
+        }),
         "model.update": Object.freeze({
             scope: MODEL_SCOPE,
             description: "Rename a model's app-tree node (POST bizmodels/update with AppFunctionVO; source-pinned BizSchemaController.update:266-305 — bizSchemaCode, id=<AppFunction node id>, name, parentId are ALL validateNotEmpty-required; the tool resolves id/parentId from the app tree). The endpoint patches the MENU NODE only: the underlying schema is fixed at create (modelType refused `model-type-immutable`; get_all keeps the original type/name — the authoritative rename readback is the tree node, recordName reported informationally). Absent tree node refuses `model-update-target-absent`; an empty patch refuses `model-update-empty-patch` (data title belongs to model.setSummary).",
@@ -145,6 +149,7 @@ export function assertModelContract() {
         throw new Error("model contract must require per-step authoritative readbacks");
     assertDescriptionCarries(MODEL_LANE_CONTRACT, "model.deleteMany", ["physically_delete", "List<AppDeleteParamVO>", "blockedTargets", "wait-and-recheck"]);
     assertDescriptionCarries(MODEL_LANE_CONTRACT, "model.setSummary", ["update_summary", "get_summary", "数据标题", "300014", "model-summary-empty", "model-summary-invalid", "Summary[]"]);
+    assertDescriptionCarries(MODEL_LANE_CONTRACT, "model.move", ["bizmodels/update", "parentId", "folder.tree", "folder-not-found", "moved"]);
     assertDescriptionCarries(MODEL_LANE_CONTRACT, "model.update", ["bizmodels/update", "get_all", "model-type-immutable", "model-update-target-absent", "model-update-empty-patch"]);
     if (!MODEL_WIRE.summaryWire.includes("validateNotEmpty"))
         throw new Error("model contract must carry the update_summary validateNotEmpty fact");

package/dist/lanes/model-coverage.js

@@ -8,6 +8,7 @@ export const MODEL_COVERAGE = declareLaneCoverage(MODEL_LANE_CONTRACT.lane, [
         tools: [
             claim("model.create", T["model.create"].scope),
             claim("model.update", T["model.update"].scope),
+            claim("model.move", T["model.move"].scope),
             claim("model.delete", T["model.delete"].scope),
             claim("model.deleteMany", T["model.deleteMany"].scope),
             claim("model.setSummary", T["model.setSummary"].scope),

package/dist/lanes/model.js

@@ -42,6 +42,8 @@ function modelRollbackSpec(toolName) {
             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) } }] };
+            if (toolName === "model.move")
+                return { kind: "calls", calls: snapshot.node?.parentId === undefined ? [] : [{ tool: "model.move", args: { schemaCode: code, folderId: String(snapshot.node.parentId) } }] };
             return { kind: "calls", calls: [{ tool: "model.create", args: { code, name: String(snapshot.node?.name ?? snapshot.record?.name ?? code) } }], notes: ["字段/表单/视图不随行恢复，需重建"] };
         },
     };
@@ -812,6 +814,73 @@ export function registerModelLane(tools) {
                 message: "模型类型在创建时固化——bizmodels/update 只更新应用菜单节点显示，不能把底层 schema 从 LIST 迁移为 TREE（get_all 仍返回原类型与树系统字段，live 取证）。要树模型请建新模型",
             });
     }, undefined, modelRollbackSpec("model.update"));
+    writeTool(tools, "model.move", MODEL_LANE, "move a model's app-tree node to another folder (bizmodels/update parentId)", "把模型移动到指定应用目录（分组）：`POST bizmodels/update` 的 `parentId`（与 model.update 同一端点，AppFunctionController 补丁语义：bizSchemaCode/id/name/parentId 全量必填，工具从应用树解析）。`folderId` 必须是目录节点 id（`folder.tree` 的 id），**不能直接给目录名**——重名目录会定位错。移动后按应用树回读 `parentId/path` 确认；模型的 schema、字段、表单、视图都不动，只换菜单节点归属。目标目录不存在时拒绝 `folder-not-found` 并列出目录树。", {
+        schemaCode: z.string().min(1),
+        folderId: z.string().min(1).describe("目标目录 id（folder.tree 的 id）；顶层目录也是真实 id，不要传空"),
+        applicationCode: z.string().optional().describe("模型所在应用 code（跨应用时显式给）"),
+    }, async (session, args) => {
+        const resolved = await resolveModelTreeNode(session, args.schemaCode, args.applicationCode);
+        if (!resolved.node)
+            throw new ToolRefusalError({
+                status: "refused",
+                blocker: "model-update-target-absent",
+                schemaCode: args.schemaCode,
+                message: `模型 ${args.schemaCode} 无应用树节点——确认 schemaCode/应用 code（model.move 只改 AppFunction 节点归属）`,
+            });
+        const appCode = resolved.applicationCode;
+        const tree = resolved.treeRows.length > 0 ? resolved.treeRows : flattenTreeRows(wireRows((await wireCall(session, { path: ENDPOINTS.applicationTree, query: { appCode } })).data));
+        const target = tree.find((row) => String(row.id ?? "") === args.folderId);
+        if (!target || String(target.type ?? "") !== "Folder") {
+            // A folder from ANOTHER application is the common miss (the model and
+            // the folder must live in the same app tree). Name that instead of a
+            // bare "not found".
+            const apps = wireRows((await wireCall(session, { path: ENDPOINTS.applicationList, query: {} })).data);
+            let otherApp;
+            for (const app of apps) {
+                const candidate = String(app.appCode ?? app.code ?? "");
+                if (!candidate || candidate === appCode)
+                    continue;
+                const rows = flattenTreeRows(wireRows((await wireCall(session, { path: ENDPOINTS.applicationTree, query: { appCode: candidate } })).data));
+                if (rows.some((row) => String(row.id ?? "") === args.folderId && String(row.type ?? "") === "Folder")) {
+                    otherApp = candidate;
+                    break;
+                }
+            }
+            throw new ToolRefusalError({
+                status: "refused",
+                blocker: otherApp ? "folder-other-application" : "folder-not-found",
+                folderId: args.folderId,
+                applicationCode: appCode,
+                ...(otherApp ? { folderApplicationCode: otherApp } : {}),
+                available: tree.filter((row) => row.type === "Folder").map((row) => ({ id: row.id, name: row.name })).slice(0, 40),
+                message: otherApp
+                    ? `目录 ${args.folderId} 属于应用 ${otherApp}，而模型 ${args.schemaCode} 在应用 ${appCode}——模型的目录必须同应用；跨应用请先在 ${appCode} 建同名目录再移动`
+                    : `应用 ${appCode} 没有目录 ${args.folderId}——folderId 必须用 folder.tree 的目录节点 id（不是目录名）`,
+            });
+        }
+        const node = resolved.node;
+        const nodeId = String(node.id ?? "");
+        const beforeParent = String(node.parentId ?? "");
+        const performed = await wireCall(session, {
+            path: ENDPOINTS.modelUpdate,
+            method: "POST",
+            body: { bizSchemaCode: args.schemaCode, id: nodeId, parentId: args.folderId, name: String(node.name ?? args.schemaCode) },
+        });
+        const after = await resolveModelTreeNode(session, args.schemaCode, appCode);
+        const parentNow = String(after.node?.parentId ?? "");
+        return {
+            performed: { errcode: performed.errcode },
+            readback: {
+                schemaCode: args.schemaCode,
+                applicationCode: appCode,
+                moved: parentNow === args.folderId,
+                beforeParentId: beforeParent,
+                afterParentId: parentNow || null,
+                folder: { id: args.folderId, name: target.name ?? null },
+                note: "只改菜单节点归属；schema/字段/表单/视图与发布状态都不动",
+            },
+        };
+    }, undefined, undefined, modelRollbackSpec("model.move"));
     registerPackageTool(tools, {
         name: "configure_model",
         lane: MODEL_LANE,

package/dist/tools.js

@@ -4,6 +4,7 @@ import { registerMetaLane } from "./lanes/meta.js";
 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 { registerModelLane } from "./lanes/model.js";
 import { registerFieldLane } from "./lanes/field.js";
 import { registerDataRuleLane } from "./lanes/datarule.js";
@@ -35,6 +36,7 @@ export function buildToolRegistry() {
     registerAppLane(tools);
     registerDictionaryLane(tools);
     registerModelLane(tools);
+    registerFolderLane(tools);
     registerFieldLane(tools);
     registerDataRuleLane(tools);
     registerFormLane(tools);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stalfh233/omc-cli",
-  "version": "0.4.76",
+  "version": "0.4.78",
   "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.76",
+    "@stalfh233/omc-fake-platform": "0.4.78",
     "commander": "14.0.3",
-    "omc-core": "0.4.76",
+    "omc-core": "0.4.78",
     "proper-lockfile": "4.1.2",
     "write-file-atomic": "6.0.0",
     "zod": "^3.23.8",

package/skills/omc-capabilities.md

@@ -25,6 +25,7 @@ only the section for the capability you need —
 | --- | --- | --- | --- |
 | 环境治理 `environment` | 环境发现/指纹/就绪 | 环境、指纹、版本、连接、登录、就绪、发现 | [环境治理](#环境治理-environment) |
 | 应用 `app` | 应用包生命周期 | 应用、门户、分组、app 建删移 | [应用](#应用-app) |
+| 应用目录（分组）`folder` | 应用树目录/分组 | 目录、分组、文件夹、应用树、移动模型到目录 | [应用目录](#应用目录分组-folder) |
 | 数据字典 `dictionary` | 字典与字典记录 | 字典、选项来源、树型、键值、字段下拉来源 | [数据字典](#数据字典-dictionary) |
 | 业务模型 `model` | 模型生命周期 | 模型、对象、表、主数据、改名、物理删除 | [业务模型](#业务模型-model) |
 | 字段 `field` | 字段族 + 子表 + **计算字段** | 字段、属性、子表、明细、下拉、单选、多选、附件、人员、部门、日期、数值、关联、**公式/计算/求和/汇总/合计/回主表** | [字段](#字段-field) |
@@ -52,9 +53,15 @@ only the section for the capability you need —
 
 ## 应用 `app`
 
-- **能做哪些事**：列出应用包、创建、改名/分组移动、删除（删除级联其模型）。
-- **工具**：`app.list`、`app.create`、`app.update`、`app.delete`
-- **边界 / 陷阱**：环境已带默认 `applicationCode`，建模**不必**先建应用；`app` 未进 intent 声明式面。**要把 intent 落到新应用**：`omc call app.create`（原子面）→ 把该环境的 `applicationCode` 指向新应用（`omc setup` 重配或改 `~/.config/omc/` 环境配置）→ 再 `intent plan/apply`，模型即落在新应用（用户实测摩擦：曾误以为应用能进 intent）。
+- **能做哪些事**：列出应用包、创建、改名/分组移动、删除（删除级联其模型）；**应用树目录（分组）的建/改名/挂载/删**，以及把模型放进目录。
+- **工具**：`app.list`、`app.create`、`app.update`、`app.delete`、`folder.tree`、`folder.create`、`folder.update`、`folder.delete`
+- **边界 / 陷阱**：**目录（分组）是应用树节点**：`folder.create` 省略 `parentId` 建的是顶层目录（平台默认挂应用根）、平台**不校验重名**（工具默认按同父同名拒绝）、`folder.delete` **非递归**（有子节点回 `DIRECTORY_NOT_EMPTY`）、树是嵌套 `children`（`folder.tree` 已递归展平给 `path/depth`，只看顶层会误判“没建成”）。模型进目录用 `model.move`。环境已带默认 `applicationCode`，建模**不必**先建应用；`app` 未进 intent 声明式面。**要把 intent 落到新应用**：`omc call app.create`（原子面）→ 把该环境的 `applicationCode` 指向新应用（`omc setup` 重配或改 `~/.config/omc/` 环境配置）→ 再 `intent plan/apply`，模型即落在新应用（用户实测摩擦：曾误以为应用能进 intent）。
+
+## 应用目录（分组）`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`）。
 
 ## 数据字典 `dictionary`
 
@@ -65,10 +72,10 @@ only the section for the capability you need —
 
 ## 业务模型 `model`
 
-- **能做哪些事**：模型创建、改名、物理删除（`absent:true` 回读）、存在性、批量删除、摘要；一次建模型+字段+表单用 `configure_model`。
-- **工具**：`model.list`、`model.inspect`、`model.create`、`model.delete`、`model.deleteMany`、`model.setSummary`、`model.update`、`configure_model`
+- **能做哪些事**：模型创建、改名、**移动到目录/分组**、物理删除（`absent:true` 回读）、存在性、批量删除、摘要；一次建模型+字段+表单用 `configure_model`。**应用目录（分组）本身**：`folder.tree` / `folder.create` / `folder.update` / `folder.delete`。
+- **工具**：`model.list`、`model.inspect`、`model.create`、`model.delete`、`model.deleteMany`、`model.setSummary`、`model.update`、`model.move`、`configure_model`、`folder.tree`、`folder.create`、`folder.update`、`folder.delete`
 - **recipe**：`omc describe configure_model --example model-with-fields-form`
-- **边界 / 陷阱**：`model.inspect <schemaCode>` 一次拿全字段/表单/列表/规则/流程摘要，别逐面 6 次调用。**保留 code**：字段 code 用 `name` 会被平台占用，须避开。**每个模型都必须建并发布默认表单**——只建模型不建/不发布表单则无法录入查看（`configure_form` 或 `form.draft(rebuild:true)` + `form.publish`）。**「汇总/统计/按月」类需求**：常见做法是**一张汇总表**（独立业务模型，如 `x_monthly_summary`）接住结果，用定时任务/规则把源数据汇总写进去——**但这按需求定**，不是写死的规则。需求确认时把"汇总表"作为常规选项提出来跟用户确认，别默认往报表或二开上引。
+- **边界 / 陷阱**：`model.inspect <schemaCode>` 一次拿全字段/表单/列表/规则/流程摘要，别逐面 6 次调用。**目录（分组）**：`folder.create` 省略 `parentId` 建的是**顶层目录**（平台默认挂应用根）；`folder.delete` **非递归**（有子节点即拒 `folder-not-empty`）；应用树是**嵌套**的，`folder.tree` 已递归展平并给 `path/depth`（只看顶层会误判“目录没建成”）。移动模型用 `model.move {schemaCode, folderId}`，`folderId` 必须是目录 **id**（给目录名会 `folder-not-found`）。**保留 code**：字段 code 用 `name` 会被平台占用，须避开。**每个模型都必须建并发布默认表单**——只建模型不建/不发布表单则无法录入查看（`configure_form` 或 `form.draft(rebuild:true)` + `form.publish`）。**「汇总/统计/按月」类需求**：常见做法是**一张汇总表**（独立业务模型，如 `x_monthly_summary`）接住结果，用定时任务/规则把源数据汇总写进去——**但这按需求定**，不是写死的规则。需求确认时把"汇总表"作为常规选项提出来跟用户确认，别默认往报表或二开上引。
 
 ## 字段 `field`
 
@@ -92,6 +99,7 @@ only the section for the capability you need —
 
 - **能做哪些事**：表单 draft-first 布局、发布、`publishedHtmlJson` 绑定读回；把已发布字段绑进默认表单；**表单工具栏按钮**（`options.customButtonJson` → publish 生成 FORM 按钮）与按钮执行。
 - **工具**：`form.get`、`form.draft`、`form.publish`、`configure_form`、`form.runButton`
+- **按钮脚本（JS）读写**：`form.get --buttonScripts` 回 `scriptData`/sha；写用 `form.publish --buttonScripts [{code,script}]`（只改已有按钮脚本），或在 `buttons[]` 里给 `script`。**视图（列表）本身没有 JS 面**（`h_biz_query` 无脚本列）；脚本只有三处：表单在线JS、按钮JS、自定义页面 JS。
 - **recipe**：`omc describe configure_form --example publish-default-form`
 - **边界 / 陷阱**：默认表单已存在，用 `configure_form`/`form.draft(rebuild)`/`form.publish(rebuild:true)` 改它，不要新建；改字段形状后刷新表单一调用 `form.publish rebuild:true`。
   - **每个模型交付前其默认表单必须已发布**：只建草稿=用户无法录入/查看。用 `configure_form` 或 `form.draft(rebuild:true)`+`form.publish` 发布。
@@ -103,6 +111,7 @@ only the section for the capability you need —
 
 - **能做哪些事**：视图表头列、排序、筛选条件生命周期（create/configure/delete）。
 - **工具**：`listview.get`、`listview.list`、`listview.create`、`listview.configure`、`listview.delete`
+- **按钮脚本（JS）读写**：`listview.get --buttonCode <code>`（或 `--buttons`）直接回 `scriptData`/`scriptBytes`/`scriptSha256`，不用翻 artifact；写用 `listview.configure --buttonScripts [{code,script}]` 只改脚本（保留其它字段），或在 `buttons[]` 里用 `script` 简写（= `actionConfig.scriptData`）。
 - **recipe**：`omc describe listview.configure --example configure-default-list`
 - **边界 / 陷阱**：默认视图已存在，`listview.configure` 省略 code 即配置默认视图。**按字段分组（queryLayer）未取证**——别猜写。