@stalfh233/omc-cli 0.4.74 → 0.4.75

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

@@ -337,6 +337,7 @@
         "workflow.update",
         "workflow.publish",
         "workflow.bindRule",
+        "workflow.setButtons",
         "workflow.delete",
         "configure_workflow",
         "workflow.validate",
@@ -363,6 +364,7 @@
       ],
       "scopes": [
         "greenfield workflow authoring",
+        "workflow node form-button checkboxes",
         "organization role member read (role/users)",
         "organization role member management scope read (role/get_ouscope)",
         "organization role group create (role/add_role_group)",
@@ -496,10 +498,12 @@
         "rule.disable",
         "rule.delete",
         "rule.disableMany",
+        "rule.run",
         "configure_rule"
       ],
       "scopes": [
-        "enable invoke disable delete"
+        "enable invoke disable delete",
+        "manual rule execution (button trigger)"
       ]
     },
     {
@@ -856,11 +860,13 @@
         "form.get",
         "form.draft",
         "form.publish",
-        "configure_form"
+        "configure_form",
+        "form.runButton"
       ],
       "scopes": [
         "publishedHtmlJson authoritative readback",
-        "draft publish publishedHtmlJson readback"
+        "draft publish publishedHtmlJson readback",
+        "form toolbar button execution"
       ]
     },
     {

package/dist/capability-overview.js

@@ -191,13 +191,22 @@ export const CAPABILITY_CUES = Object.freeze({
     model: ["模型", "对象", "主数据", "物理删除", "汇总表", "统计表", "汇总对象", "月度汇总表", "汇总模型"],
     field: ["字段", "属性", "子表", "明细", "下拉", "单选", "多选", "附件", "人员", "部门", "日期", "数值", "文本", "关联", "公式", "计算", "计算字段", "求和", "汇总", "合计", "回主表", "超链接", "地址", "表单层", "必填", "只读", "条件必填", "恒必填", "条件只读", "恒只读", "表单必填", "表单只读"],
     form: ["表单", "页面", "布局", "控件", "只读", "显示"],
-    listview: ["列表", "视图", "查询列", "筛选", "表头", "甘特"],
-    datarule: ["字段级规则", "控件规则", "校验规则", "计算拼接", "显示规则", "规则", "type1", "type2", "type3"],
+    // r10 (2026-10-22, issue §1.4): an ask for a FORM toolbar button was
+    // answered "CLI 无按钮能力" — the capability exists (`listview.configure`
+    // `buttons` with useLocation FORM + bindAction SCRIPT). Cue the compound
+    // phrases so they outweigh businessrule's generic "按钮".
+    listview: ["列表", "视图", "查询列", "筛选", "表头", "甘特", "表单按钮", "工具栏按钮", "列表按钮", "行级按钮", "自定义按钮", "工具栏"],
+    // r10 (2026-10-22): "计划日期不能早于今天" routed to `field` (it matched
+    // 日期) because no cue named the VALIDATION intent, so the agent went to the
+    // rule graph and concluded "the platform has no today variable" — wrong, and
+    // the form designer's 提交校验 (datarule type1/checkType2) is the real face.
+    datarule: ["字段级规则", "控件规则", "校验规则", "计算拼接", "显示规则", "规则", "type1", "type2", "type3",
+        "不早于", "不能早于", "不晚于", "不能晚于", "早于今天", "晚于今天", "日期校验", "提交校验", "校验不通过", "必填校验", "正则校验", "重复校验", "长度校验"],
     // NOTE: bare "自动" was a cue (round 10 bug: "自动识别"/"自动发邮件" matched
     // businessrule and routed an UNSUPPORTED ask onto the write ladder). A business
     // rule is named by 业务规则/触发器/规则图, not by "automatic".
     businessrule: ["业务规则", "触发器", "规则图", "校验", "事件", "按钮", "定时任务", "定时触发", "定时器", "每天", "每日", "周期执行", "调度", "SCHEDULER", "TIMING_TASK"],
-    "rule-lifecycle": ["启用规则", "停用规则", "删除规则", "规则启停"],
+    "rule-lifecycle": ["启用规则", "停用规则", "删除规则", "规则启停", "触发规则", "执行规则", "跑规则", "按钮规则", "规则验收"],
     workflow: ["流程", "工作流", "审批", "节点", "待办", "流转", "参与人", "审批人", "角色", "部门负责人", "审批角色"],
     onlinejs: ["在线js", "脚本", "联动", "onload", "onvalidate"],
     bizservice: ["集成", "接口", "服务", "回调", "对接", "外部系统", "datasql", "restful"],

package/dist/cli.js

@@ -327,8 +327,15 @@ async function cmdCall(store, args) {
         validateAgentPaths(parsedArgs);
     }
     catch (error) {
-        console.error(`--args 必须是合法 JSON：${error instanceof Error ? error.message : String(error)}（Windows PowerShell 下内联 JSON 引号转义不可靠，请改用 --args-file <path> 写入临时文件后引用）`);
-        writeEnvelope(envelope("error", {}, request, { code: "invalid-input", message: error instanceof Error ? error.message : String(error), retryable: false }));
+        const detail = error instanceof Error ? error.message : String(error);
+        // r10 F9: an out-of-root `--args-file` was reported under "--args 必须是
+        // 合法 JSON", which points the reader at the wrong flag. Name the real
+        // cause (and the configuration root) when the failure came from the file.
+        const message = /must be inside the configuration root/.test(detail)
+            ? `--args-file 越界：${detail}（只接受配置根 ${resolve(process.env.OMC_CONFIG_HOME ?? process.cwd())} 内的路径；把参数文件放进项目目录后重试）`
+            : `--args 必须是合法 JSON：${detail}（Windows PowerShell 下内联 JSON 引号转义不可靠，请改用 --args-file <path> 写入临时文件后引用）`;
+        console.error(message);
+        writeEnvelope(envelope("error", {}, request, { code: "invalid-input", message: detail, retryable: false }));
         return CLI_EXIT_CODES.invalidInput;
     }
     const registry = buildToolRegistry();
@@ -1174,7 +1181,15 @@ const request = requestId();
 main().then((code) => {
     // Commands that own their stdout never grow a trailing envelope. `--version`/
     // `-V` are here because their short-circuit already wrote the bare version.
-    if (argv[2] === "call" || argv[2] === "script" || argv[2] === "artifact" || argv[2] === "commands" || argv[2] === "describe" || argv[2] === "contract" || argv[2] === "capabilities" || argv[2] === "capability" || argv[2] === "next" || argv[2] === "usage" || argv[2] === "intent" || argv[2] === "help" || argv[2] === "--version" || argv[2] === "-V") {
+    // Composers (`form-default`, `compute`, `rule-when`, `approval-flow`) own their
+    // stdout exactly like `call` does. Without them in this list every composer
+    // printed its real envelope AND a trailing `{"ok":true,"result":{}}` — r10 read
+    // that as a second, empty answer. `rollback` / `env` emit their own
+    // envelope (or, for `env --json`, their own JSON) and were printing a second
+    // empty envelope after it (live 2026-10-23: `omc rollback apply` answered two
+    // lines, violating the one-envelope stdout contract).
+    const ownsStdout = ["call", "script", "artifact", "commands", "describe", "contract", "capabilities", "capability", "next", "usage", "intent", "help", "form-default", "compute", "rule-when", "approval-flow", "rollback", "env", "--version", "-V"];
+    if (ownsStdout.includes(argv[2] ?? "")) {
         completeUsage(code);
         finish(code);
         return;

package/dist/endpoints.js

@@ -58,6 +58,30 @@ export const ENDPOINTS = {
     businessRuleNodeRunMap: "/api/api/app/businessrule/node_run_map",
     businessRuleEnable: "/api/api/app/businessrule/enable",
     businessRuleDelete: "/api/api/app/businessrule/delete",
+    /**
+     * Manual execution of a CUSTOM-trigger rule (the list/form button path).
+     * Live 2026-10-23 (AI-Platform 1.1.25, Playwright capture of a
+     * `listview.configure` BUSINESS_RULE row button):
+     *   POST /api/api/launcher/domain_service_runtime/<schemaCode>/<ruleCode>
+     *   body {schemaCode, ids:[bizObjectId...], ruleCode, consolidation:false}
+     *   → {errcode:0, errmsg:"Execution Completed", data:[<pre-execution bizObjects>], traceId}
+     * The response objects are the PRE-execution snapshot (the frontend sends
+     * reacquireDataFromDb:false), so effects must be read back separately.
+     */
+    ruleRuntimeExecuteBase: "/api/api/launcher/domain_service_runtime",
+    /**
+     * Form-toolbar button execution — a DIFFERENT face from the list-button one.
+     * Live 2026-10-23 (1.1.25, Playwright capture of a `triggerType=FORM` button
+     * rendered on /form/detail):
+     *   POST /api/api/runtime/form/executeCustomButton
+     *   {bizButtonModel:<the h_biz_button row>, bizObjectList:[<full bizObject>],
+     *    reacquireDataFromDb:true}
+     * The list button posts ids to the launcher path instead; the two are not
+     * interchangeable.
+     */
+    runtimeFormExecuteCustomButton: "/api/api/runtime/form/executeCustomButton",
+    /** Designer's form-button inventory: form trigger infos + their BizButtonModels. */
+    systemGetCustomButtons: "/api/api/system/getCustomButtons",
     dataRuleCreate: "/api/api/app/bizdatarule/create",
     dataRuleList: "/api/api/app/bizdatarule/list",
     dataRuleUpdate: "/api/api/app/bizdatarule/update",

package/dist/form-default.js

@@ -14,9 +14,14 @@
  * 将要做的修改。
  */
 import { runToolCall } from "./call.js";
+import { readFileSync } from "node:fs";
+import { readArtifact } from "./artifacts.js";
+import { artifactRoot } from "./command-transport.js";
 import { envelope, requestId, classifyResult, CLI_EXIT_CODES } from "./cli-contract.js";
 import { writeEnvelope } from "./cli-output.js";
 import { argvValue } from "./args.js";
+/** Sub-calls must not print their own envelopes (the composer owns stdout). */
+const silent = () => { };
 /** 从 form.get 结果提取控件数组（draft 优先，published 兜底）。 */
 function toControlList(value) {
     if (Array.isArray(value))
@@ -35,6 +40,64 @@ function extractControls(formGet) {
         return { controls: published, face: "published" };
     return undefined;
 }
+/**
+ * `form.get` summarizes large JSON as `{length, sha256}` (token diet), and with
+ * `controls:true` even the control LISTS come back as `{keys, sha256}` — treating
+ * those as arrays yields "2 controls". The raw faces ride the detail artifact.
+ *
+ * r10 (2026-10-22) F1: `form-default --apply` cloned that摘要 as the draft, wrote
+ * a 2-control form, and `form.publish`'s degrade guard then refused its own
+ * output (`form-publish-degrade`, 7 identical failures).
+ */
+function readDetailForm(result) {
+    // In-process composers see `detailFile` (the tool's own artifact path); the CLI
+    // transport rewrites it to `detailArtifactId` before printing. Handle both.
+    const raw = (() => {
+        if (typeof result?.detailArtifactId === "string") {
+            try {
+                return readArtifact(artifactRoot(), result.detailArtifactId).content.toString("utf8");
+            }
+            catch {
+                return undefined;
+            }
+        }
+        if (typeof result?.detailFile === "string") {
+            try {
+                return readFileSync(result.detailFile, "utf8");
+            }
+            catch {
+                return undefined;
+            }
+        }
+        return undefined;
+    })();
+    if (raw === undefined)
+        return undefined;
+    try {
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function parseJsonColumn(value) {
+    if (typeof value !== "string")
+        return value;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The published control map `{ <controlKey>: {key,type,options} }`, raw. */
+function controlMap(value) {
+    const parsed = parseJsonColumn(value);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+        return undefined;
+    return parsed;
+}
 export async function cmdFormDefault(args) {
     const request = requestId();
     const flag = (name) => argvValue(args, name);
@@ -51,7 +114,7 @@ export async function cmdFormDefault(args) {
     if (!schema || !field || value === undefined)
         return invalid("--schema/--field/--default 均必填");
     // 1) 读控件（单控件投影，拿全对象含 options）
-    const getOutcome = await runToolCall("form.get", { args: { schemaCode: schema, controls: [field], ...(environment ? { environment } : {}) }, requestId: request, environment });
+    const getOutcome = await runToolCall("form.get", { args: { schemaCode: schema, controls: [field], ...(environment ? { environment } : {}) }, requestId: request, environment, print: silent });
     if (getOutcome.exitCode !== 0) {
         const classified = classifyResult(getOutcome.result);
         writeEnvelope(envelope(classified.status, getOutcome.result, request, classified.error));
@@ -73,34 +136,58 @@ export async function cmdFormDefault(args) {
         writeEnvelope(envelope("ok", { schemaCode: schema, field, from: options.defaultValue === value ? undefined : control, to: nextControl, dryRun: true, note: "--apply 执行 form.draft→form.publish" }, request));
         return 0;
     }
-    // 2) form.draft：需要完整 draftAttributesJson——单控件投影不够，取全量控件面
-    const getAll = await runToolCall("form.get", { args: { schemaCode: schema, controls: true, ...(environment ? { environment } : {}) }, requestId: request, environment });
+    // 2) form.draft：需要完整 draftAttributesJson——单控件投影不够，取发布面的全量控件
+    // 图。`controls:true` / `full:true` 的大字段在 CLI 面被摘要成 {length,sha256}
+    // 或 {keys,sha256}，必须从 detail artifact 取原始 JSON。
+    const getAll = await runToolCall("form.get", { args: { schemaCode: schema, full: true, ...(environment ? { environment } : {}) }, requestId: request, environment, print: silent });
     if (getAll.exitCode !== 0) {
         const classified = classifyResult(getAll.result);
         writeEnvelope(envelope(classified.status, getAll.result, request, classified.error));
         return getAll.exitCode;
     }
-    const fullExtracted = extractControls(getAll.result ?? {});
-    if (!fullExtracted)
+    const detail = readDetailForm(getAll.result) ?? (getAll.result ?? {});
+    const publishedAttrs = controlMap(detail.publishedAttributesJson);
+    const draftAttrs = controlMap(detail.draftAttributesJson);
+    const publishedCount = publishedAttrs ? Object.keys(publishedAttrs).length : 0;
+    const draftCount = draftAttrs ? Object.keys(draftAttrs).length : 0;
+    // Clone the COMPLETE face: a partial draft (or a 摘要) would shrink the form and
+    // trip the platform's own degrade guard at publish time.
+    const base = draftAttrs && draftCount >= publishedCount && draftCount > 0 ? draftAttrs : publishedAttrs;
+    if (!base || Object.keys(base).length === 0)
         return invalid("form.get 未取到任何控件（表单为空？先发布默认表单）");
-    const fullControls = fullExtracted.controls.map((c) => (String(c.key ?? c.dataItemName ?? "") === field ? nextControl : c));
+    const controlKey = Object.keys(base).find((key) => key === field)
+        ?? Object.keys(base).find((key) => String(base[key].key ?? "") === field);
+    if (!controlKey)
+        return invalid(`发布面里没有字段 "${field}" 的控件——先 field.publish 并 form.publish`);
+    const cloned = JSON.parse(JSON.stringify(base));
+    const targetControl = cloned[controlKey];
+    const targetOptions = (targetControl.options ?? {});
+    targetOptions.defaultValue = Array.isArray(targetOptions.defaultValue) ? [value] : value;
+    targetControl.options = targetOptions;
+    const draftViewRaw = detail.publishedViewJson ?? detail.draftViewJson;
+    const draftView = parseJsonColumn(draftViewRaw);
     const draftOutcome = await runToolCall("form.draft", {
-        args: { schemaCode: schema, draftAttributesJson: JSON.stringify(fullControls), ...(environment ? { environment } : {}) },
-        requestId: request, environment,
+        args: {
+            schemaCode: schema,
+            draftAttributesJson: JSON.stringify(cloned),
+            ...(draftView !== undefined ? { draftViewJson: JSON.stringify(draftView) } : {}),
+            ...(environment ? { environment } : {}),
+        },
+        requestId: request, environment, print: silent,
     });
     if (draftOutcome.exitCode !== 0) {
         const classified = classifyResult(draftOutcome.result);
         writeEnvelope(envelope(classified.status, draftOutcome.result, request, classified.error));
         return draftOutcome.exitCode;
     }
-    const publishOutcome = await runToolCall("form.publish", { args: { schemaCode: schema, ...(environment ? { environment } : {}) }, requestId: request, environment });
+    const publishOutcome = await runToolCall("form.publish", { args: { schemaCode: schema, ...(environment ? { environment } : {}) }, requestId: request, environment, print: silent });
     if (publishOutcome.exitCode !== 0) {
         const classified = classifyResult(publishOutcome.result);
         writeEnvelope(envelope(classified.status, publishOutcome.result, request, classified.error));
         return publishOutcome.exitCode;
     }
     // 3) 权威回读
-    const verify = await runToolCall("form.get", { args: { schemaCode: schema, controls: [field], ...(environment ? { environment } : {}) }, requestId: request, environment });
+    const verify = await runToolCall("form.get", { args: { schemaCode: schema, controls: [field], ...(environment ? { environment } : {}) }, requestId: request, environment, print: silent });
     const verifyResult = verify.result ?? {};
     const verifyControls = extractControls(verifyResult)?.controls ?? [];
     const verifyControl = verifyControls.find((c) => String(c.key ?? c.dataItemName ?? "") === field);