@stalfh233/omc-cli 0.4.77 → 0.4.79

package/README.md

@@ -18,6 +18,15 @@
   （x=327、158×40、y=36/116/196…），缺失路由坐标按节点**边中点**推导，缺失
   `routeCondition`/`matchType` 补 `true`/`ANY`；已可渲染的布局与分支图原样保留
   ——调用方无需手算几何。
+- **读面一步取值**——大结果落到 artifact 时，`omc call <tool> … --extract <path>` / `--extract-keys`
+  直接在**同一次调用**里取值，不必再跑一次 `artifact get`；路径支持 `.rules[code=Create].name`
+  这类数组选择器。
+- **脚本面可读写**——表单在线 JS（`onlinejs.get/compose`）与**按钮 JS**
+  （`listview.get --buttonCode` / `listview.configure --buttonScripts`、
+  `form.get --buttonScripts` / `form.publish --buttonScripts`）都能一次读写，
+  不必翻 artifact、也不必重发整张按钮表。
+- **应用目录（分组）**——`folder.tree/create/update/delete` + `model.move`；
+  应用树是嵌套 `children`，读面已递归展平并给 `path`/`depth`。
 - **方法论即可读**——`skills/` 下的方法论通过 `omc help <topic>` 按需读取；agent 不必去翻仓库文件。
 - **凭据零回显**——凭据（0600 存储或环境变量）不会出现在任何输出、产物或错误里。
 - **不确定性语义**——传输失败时冻结（`status: "uncertain", frozen: true`），
@@ -51,12 +60,12 @@ omc call discover_environment --env <env> --args '{}'   # 环境就绪（真实
 `describe` 与 `contract` 重复所选能力路由，切换面不必再宽扫 topic 或契约。
 `omc eval:discovery-comparison` 输出相对 ticket 01 基线的调用数/字节数对比。
 
-## 工具面（90 个工具）
+## 工具面（142 个工具）
 
 | 类别 | 数量 | 说明 |
 |---|---|---|
-| 写工具 | 56 | 高层编排 4（`configure_*` + `apply_changes`）+ 低层原子写 52 |
-| 读工具 | 29 | `*.list` / `*.get` / `*.load` / `discover_environment` |
+| 写工具 | 87 | 高层编排 5（`configure_*` + `apply_changes`）+ 低层原子写 82 |
+| 读工具 | 50 | `*.list` / `*.get` / `*.load` / `*.tree` / `discover_environment` |
 | 治理/元工具 | 5 | `get_status`、`doctor`、`coverage.manifest`、`setup.*` |
 
 **全集与逐工具参数**：`omc commands --json`（name/lane/kind/requiredArgs/writeGate/timeout）、
@@ -73,22 +82,27 @@ omc call discover_environment --env <env> --args '{}'   # 环境就绪（真实
 | `setup.start` | 配置引导入口：返回待填字段与当前非密值 |
 | `setup.commit` | 幂等提交环境配置（写 `omc.config.json` + 0600 凭据库），随后跑连通性+登录+版本族校验 |
 
-### 读工具（29）
+### 读工具（50）
 
 | 域（lane） | 工具 |
 |---|---|
 | 环境 `environment-governance` | `discover_environment`、`environment.fingerprint` |
 | 应用 `app-management` | `app.list` |
+| 应用目录 `app-tree-folders` | `folder.tree`（递归展平嵌套 `children`，给 `path`/`depth`；`foldersOnly` 只回目录） |
 | 数据字典 `dictionary-management` | `dictionary.list`、`dictionary.type`、`dictionary.names`、`dictionary.get`、`dictionary.records`、`dictionary.parent`、`dictionary.classes` |
+| 业务模型 `model-management` | `model.list`、`model.inspect`（一次拿全字段/表单/视图/规则/流程摘要） |
 | 字段 `field-families` | `field.list` |
-| 表单 `form-publish-chain` | `form.get` |
+| 表单 `form-publish-chain` | `form.get`（紧凑面直接回 `formButtons`/`formButtonCodes`；`--buttonScripts` 回按钮 JS 原文与 sha） |
+| 列表视图 `W1-list-view` | `listview.get`（`--buttonCode`/`--buttons` 直接回按钮 JS 的 `scriptData`/sha）、`listview.list` |
 | 字段级规则 `G1-datarule` | `datarule.list` |
 | 业务规则 `B1-businessrule` | `rule.list`、`rule.get` |
-| 流程 / 待办 `W7-S29-greenfield` | `workflow.get_draft`、`workflow.get_published`、`workitem.list` |
+| 流程 / 待办 / 组织 `W7-S29-greenfield` | `workflow.get_draft`（每节点 `formButtons.enabled/disabled`）、`workflow.get_published`、`workflow.validate`、`workflow.instanceActivity`、`workitem.list`、`org.role.list`、`org.role.users`、`org.role.userScope`、`org.department.list`、`org.department.users`、`org.user.search`、`org.user.info`、`org.user.departments` |
+| 在线脚本 `online-js` | `onlinejs.get`（草稿/发布面 `customScript` 原文 + SHA-256） |
 | 运行数据 `M2-runtime-data` | `data.list`、`data.load` |
-| 业务集成 `B2-registration` | `service.get`、`method.get`、`service.category.list`、`service.dbconnpool.list`、`service.adapter_config`、`service.table_list`、`service.table_sql`、`service.export`、`service.check` |
+| 报表 `R1-report` | `report.tree`、`report.get`、`report.chartdata`、`report.datasource.list` |
+| 业务集成 `B2-registration` | `service.list`、`service.get`、`method.get`、`service.category.list`、`service.dbconnpool.list`、`service.adapter_config`、`service.table_list`、`service.table_sql`、`service.export`、`service.check` |
 
-## 能力总览（14 项）
+## 能力总览（16 项）
 
 `omc capabilities` 的静态快照；跑 `omc capabilities` / `omc capability <id>` 取实时投影。
 「依赖」= `requires → precedes`，即能力之间的配置顺序。
@@ -96,53 +110,73 @@ omc call discover_environment --env <env> --args '{}'   # 环境就绪（真实
 | 能力 | 标题 | lane | 覆盖 | intent | 依赖 |
 |---|---|---|---|---|---|
 | `environment` | 环境治理 | `environment-governance` | executable | none | - → - |
-| `app` | 应用 | `app-management` | executable | none | - → - |
+| `app` | 应用 | `app-management` | executable | none | - → folder |
+| `folder` | 应用目录（分组） | `app-tree-folders` | executable | none | app → - |
 | `dictionary` | 数据字典 | `dictionary-management` | executable | none | - → - |
 | `model` | 业务模型 | `model-management` | executable | partial | - → field, workflow |
-| `field` | 字段（含子表） | `field-families` | executable | partial | model → form, listview, datarule, businessrule, data |
+| `field` | 字段（含子表、计算字段） | `field-families` | executable | partial | model → form, listview, datarule, businessrule, data |
 | `form` | 默认表单 | `form-publish-chain` | executable | partial | field → onlinejs |
 | `listview` | 列表视图 | `W1-list-view` | partial | partial | field → - |
 | `datarule` | 字段级控件规则 | `G1-datarule` | partial | partial | field → - |
-| `businessrule` | 业务规则（图形引擎） | `B1-businessrule` | executable | partial | field → rule-lifecycle |
+| `businessrule` | 业务规则（图形引擎，含定时任务） | `B1-businessrule` | executable | partial | field → rule-lifecycle |
 | `rule-lifecycle` | 规则生命周期 | `S25-rule-lifecycle` | executable | none | businessrule → - |
 | `workflow` | 流程模板 | `W7-S29-greenfield` | executable | partial | model → - |
 | `onlinejs` | 表单在线 JS | `online-js` | executable | partial | form → - |
 | `bizservice` | 业务集成 | `B2-registration` | executable | partial | - → - |
+| `report` | 报表 | `R1-report` | partial | partial | - → - |
 | `data` | 运行数据 | `M2-runtime-data` | executable | none | field → - |
 
 - **覆盖**：`executable` 全量可用；`partial` 有取证边界（见 `omc capability <id>` 的 notes）。
 - **intent**：`partial` 表示该能力可声明式（`omc intent`）覆盖一部分——通常 create/update；
   `none` 表示只走 `omc call`。删除类、方法面、分类/连接池等仍走 `omc call` 逃生舱。
 
+## 近期能力（0.4.74 → 0.4.78）
+
+| 版本 | 新增 / 修复 |
+|---|---|
+| 0.4.78 | **按钮 JS 直接读写**：`listview.get --buttonCode/--buttons`、`listview.configure --buttonScripts`、`form.get --buttonScripts`、`form.publish --buttonScripts`，外加 `buttons[].script` 简写 |
+| 0.4.77 | **应用目录（分组）**：`folder.tree/create/update/delete` + `model.move`（`bizmodels/update` 换 parentId，跨应用目录单独报错） |
+| 0.4.76 | **读面一键取值**：`call --extract <path>`（可重复）/`--extract-keys`，省掉一次 `artifact get`；`form.draft fromReadback:true` 允许平台原样布局回写；`--jq` 支持数组选择器 `[code=X]` |
+| 0.4.75 | 节点级事件 `workflow.bindRule {activityCode,nodeEvent}`；`workflow.update` merge 拓扑保护（边数收缩即拒）；`workflow.setButtons`；`rule.run` / `form.runButton`；表单按钮 `options.customButtonJson` |
+| 0.4.74 | 组织写面 15 工具（角色组/角色/成员/管理范围/部门/用户） |
+
+> **脚本面只有三处**：表单在线 JS（`onlinejs.*`）、按钮 JS（本轮补齐读写）、自定义页面 JS
+> （`h_custom_page`，CLI 未覆盖）。**列表视图本身没有 JS 面**（`h_biz_query` 无脚本列）。
+
 ## 写工具做什么
 
 写工具分三层用法，**全部走同一条受治理管道**。
 
-### 1. 高层编排（4 个，一次调用 = 一个变更包）
+### 1. 高层编排（5 个，一次调用 = 一个变更包）
 
 | 工具 | 作用 |
 |---|---|
 | `configure_model` | 建模型 → 建 1..N 个字段 → 模型级 `field.publish`，`publishForm:true` 时再 `form.draft` + `form.publish`，一步到达**结构可用形态**。字段族门逐字段在写入前拒绝。 |
 | `configure_form` | 给模型配默认表单：`fieldCodes` 决定绑定哪些已发布字段（按序；省略=全量；未知 code 在建表前拒绝 `form-fieldcodes-unknown`），再发布。 |
 | `configure_rule` | 保存并启用一条业务规则（graph 规则引擎）——委托 `rule.save` 的 upsert + `rule.enable`。 |
+| `configure_workflow` | 建流程模板 → 写活动/路由 → 发布 → 绑定事件规则，一步到达可发起形态（节点级事件用 `workflow.bindRule {activityCode,nodeEvent}`）。 |
 | `apply_changes` | **批量入口**：一次提交异构变更清单 `changes:[{tool,args}]`（只收低层原子写工具），按序执行、逐步权威读回、**首败即停**并报已完成步骤与失败点；每步传输超时按 `uncertain` 冻结。含**整批时间预算** `totalTimeoutMs`（缺省 8 分钟）：超预算即停并返回 `uncertain` + `progressFile` + `resumeFromIndex`，绝不盲重试。 |
 
-### 2. 低层原子写（52 个，按域）
+### 2. 低层原子写（82 个，按域）
 
 | 域（lane） | 工具 |
 |---|---|
-| 模型 `model-management` | `model.create`、`model.update`（应用树节点改名补丁：bizSchemaCode/id/name/parentId 四键必需，modelType 恒拒——类型创建时固化）、`model.setSummary`（数据标题/摘要模板）、`model.delete`、`model.deleteMany`（一次 `physically_delete` 请求批量删；逐目标引用预检、被引用整批拒绝零副作用、逐模型缺席轮询；跨应用自动解析 AppFunction id） |
-| 字段 `field-families` | `field.create`、`field.update`、`field.delete`、`field.publish`（模型级一次发布；发布后逐字段读 `bizproperty/get` 比对 name/propertyType，与草稿面不一致即拒绝——不只查发布列表存在性） |
-| 表单 `form-publish-chain` | `form.draft`、`form.publish` |
+| 模型 `model-management` | `model.create`、`model.update`（应用树节点改名补丁：bizSchemaCode/id/name/parentId 四键必需，modelType 恒拒）、`model.move`（换目录，只改菜单节点归属）、`model.setSummary`、`model.delete`、`model.deleteMany` |
+| 应用目录 `app-tree-folders` | `folder.create`（省略 `parentId` = 顶层；同父同名默认拒）、`folder.update`（改名/挂载）、`folder.delete`（非递归，有子节点即拒） |
+| 字段 `field-families` | `field.create`、`field.update`、`field.delete`、`field.publish`（模型级一次发布 + 逐字段读回比对） |
+| 表单 `form-publish-chain` | `configure_form`、`form.draft`（`buttons`/`buttonScripts`/`fromReadback`）、`form.publish`（`buttons`/`buttonScripts`）、`form.runButton`（表单按钮执行，`runtime/form/executeCustomButton`） |
 | 字段级规则 `G1-datarule` | `datarule.create`、`datarule.update`、`datarule.delete` |
-| 业务规则图 `B1-businessrule` / `S25-rule-lifecycle` | `rule.save`、`rule.enable`、`rule.disable`、`rule.delete` |
+| 业务规则图 `B1-businessrule` | `rule.save`、`rule.node.update` |
+| 规则生命周期 `S25-rule-lifecycle` | `configure_rule`、`rule.enable`、`rule.disable`、`rule.disableMany`、`rule.delete`、`rule.run`（自定义规则手动执行/按钮验收） |
 | 运行时数据 `M2-runtime-data` | `data.save`、`data.update`、`data.submit`、`data.delete` |
-| 流程 `W7-S29-greenfield` | `workflow.create`、`workflow.update`、`workflow.publish`、`workflow.bindRule`（支持 `ruleCodes[]` 一次绑多规则，MERGE 语义）、`workflow.delete` |
-| 在线脚本 `online-js` | `onlinejs.compose`（唯一工具；平台模板保真，SHA-256 读回）。后端的「在线开发」（`/api/api/programming` Java 源码）用二开扩展包，不在本 CLI 范围 |
-| 列表视图 `W1-list-view` | `listview.create`、`listview.configure`、`listview.delete`（列/排序/筛选字段引用可给 **propertyCode 或字段显示名**，唯一匹配自动解析，歧义或不存在则拒绝，不静默跳过） |
+| 流程 / 组织 `W7-S29-greenfield` | `configure_workflow`、`workflow.create`、`workflow.update`、`workflow.publish`、`workflow.bindRule`（流程级 `handler` 或节点级 `activityCode+nodeEvent`）、`workflow.setButtons`（节点「表单操作」勾选）、`workflow.delete`；组织：`org.roleGroup.create/delete`、`org.role.create/update/delete`、`org.role.addUsers/removeUsers/setUserScope`、`org.department.create/update/delete`、`org.user.create/update/delete/transferDepartment` |
+| 在线脚本 `online-js` | `onlinejs.compose`（表单在线 JS；平台模板保真 + SHA-256 读回） |
+| 列表视图 `W1-list-view` | `listview.create`、`listview.configure`（`buttons[].script` / `buttonScripts` 直接写按钮 JS）、`listview.delete` |
 | 应用 `app-management` | `app.create`、`app.update`、`app.delete` |
-| 数据字典 `dictionary-management` | `dictionary.save`（字典/记录 upsert，KEY_VALUE/TREE）、`dictionary.status`（启停字典或记录）、`dictionary.usage`（批量 `initialUsed`）、`dictionary.class.save`、`dictionary.class.delete` |
-| 后端服务注册 `B2-registration` | `service.register`、`service.update`、`service.delete`、`method.update`、`method.delete`、`method.test`、`service.import`、`service.category.create`、`service.category.update`、`service.category.delete`、`service.dbconnpool.create`、`service.dbconnpool.update`、`service.dbconnpool.delete` |
+| 数据字典 `dictionary-management` | `dictionary.save`、`dictionary.status`、`dictionary.usage`、`dictionary.class.save`、`dictionary.class.delete` |
+| 报表 `R1-report` | `report.create`、`report.update`、`report.configure`、`report.datasource.link`、`report.delete` |
+| 后端服务注册 `B2-registration` | `service.register/update/delete/import`、`method.create/update/delete/test`、`service.category.create/update/delete`、`service.dbconnpool.create/update/delete` |
+| 批量编排（lane-less） | `apply_changes` |
 
 ### 3. 每个写调用都经过的治理管道
 
@@ -186,7 +220,8 @@ omc intent readback intent.yaml --env <env>  # 解码回 intent 形状做等价
 
 | 命令 | 作用 |
 |---|---|
-| `omc artifact get <id>` | 取回大读回的 `detailFile` 工件（0600，校验 sha256） |
+| `omc artifact get <id> [--summary\|--keys\|--jq <path>]` | 取回大读回的 `detailFile` 工件（0600，校验 sha256） |
+| `omc call <tool> … --extract <path>` | **一步取值**：在本次结果的 artifact 内解析路径并直接回值（可重复给多个路径）；`--extract-keys` 列顶层键与体积。路径支持 `.rules[code=Create].name` 这种数组选择器，免掉一次 `artifact get` |
 | `omc setup [--list\|--edit <env>\|--remove <env>]` | 命名环境的增删改查 |
 | `omc doctor [--environment <env>]` | 只报告的健康链 |
 | `omc bench [--live-sample] [--env <env>]` | 工具面/wire 面的双面埋点跑分（离线 fake 或 live 采样） |
@@ -204,7 +239,7 @@ omc intent readback intent.yaml --env <env>  # 解码回 intent 形状做等价
 
 ```
 coverage/   m1-coverage-manifest-v1.json（能力基线）
-skills/     12 篇方法论 topic —— 以 `omc help <topic>` 暴露（见「方法论 topics」）
+skills/     13 篇方法论 topic —— 以 `omc help <topic>` 暴露（见「方法论 topics」）
 docs/       tool-surface-map.md —— 工具面地图
 src/        args/support/plan/read/write/package/context（治理管道）
             lanes/（各域适配器）· fake/（离线夹具）
@@ -246,7 +281,7 @@ src/        args/support/plan/read/write/package/context（治理管道）
 
 ## npm 分发
 
-本包（`@stalfh233/omc-cli`，可执行命令仍是 `omc`）通过公共 npm registry 分发。`omc-core` 是 `omc-cli` 的内部依赖，发布时先发 `omc-core`，再发 `omc-cli`；两者版本保持一致。当前版本为 `0.4.36`，尚未宣称 `1.0.0` 稳定契约。
+本包（`@stalfh233/omc-cli`，可执行命令仍是 `omc`）通过公共 npm registry 分发。`omc-core` 是 `omc-cli` 的内部依赖，发布时先发 `omc-core`，再发 `omc-cli`；两者版本保持一致。当前版本为 `0.4.78`，尚未宣称 `1.0.0` 稳定契约。
 
 ### 使用已发布包
 
@@ -264,7 +299,8 @@ omc help omc-business-configuration
 
 ```bash
 npm run verify
-npm publish --workspace packages/omc-core
+npm publish --workspace omc-core
+npm publish --workspace packages/omc-fake-platform
 npm publish --workspace packages/omc-cli
 ```
 
@@ -276,7 +312,7 @@ stdout 是机器解析的 JSON，编码按消费方选择：**终端**（`isTTY`
 
 ### 版本策略
 
-- `0.2.x`：继续演进 CLI/覆盖清单/配置契约，允许新增能力和必要的行为修复。
+- `0.4.x`：继续演进 CLI/覆盖清单/配置契约，允许新增能力和必要的行为修复。
 - `1.0.0`：等 CLI 面、intent 面、覆盖清单和分发安装流程稳定后再发布；发布前应增加迁移说明和兼容性检查。
 
 ### 分发后自检

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.79",
   "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.79",
     "commander": "14.0.3",
-    "omc-core": "0.4.77",
+    "omc-core": "0.4.79",
     "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）未取证**——别猜写。