@stalfh233/omc-cli 0.4.77 → 0.4.78

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stalfh233/omc-cli",
-  "version": "0.4.77",
+  "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.77",
+    "@stalfh233/omc-fake-platform": "0.4.78",
     "commander": "14.0.3",
-    "omc-core": "0.4.77",
+    "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

@@ -99,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` 发布。
@@ -110,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）未取证**——别猜写。