@stalfh233/omc-cli 0.4.74 → 0.4.76

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/artifacts.js

@@ -83,7 +83,7 @@ export function isWithinRoot(root, candidate) {
 export function assertSafeOutputPath(root, candidate, label) {
     const normalized = resolve(root, candidate);
     if (!isWithinRoot(root, normalized))
-        throw new Error(`${label} must be inside the configuration root`);
+        throw new Error(`${label} must be inside the configuration root（配置根 ${resolve(root)}；本次解析为 ${normalized}）`);
     const parent = resolve(normalized, "..");
     if (!existsSync(parent))
         throw new Error(`${label} parent directory does not exist`);
@@ -101,7 +101,7 @@ export function assertSafeInputPath(root, candidate, label) {
     const resolvedRoot = resolve(root);
     const normalized = resolve(root, candidate);
     if (!isWithinRoot(root, normalized))
-        throw new Error(`${label} must be inside the configuration root`);
+        throw new Error(`${label} must be inside the configuration root（配置根 ${resolvedRoot}；本次解析为 ${normalized}）`);
     let current = normalized;
     while (current !== resolvedRoot) {
         try {

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

@@ -17,7 +17,8 @@ import { configureOutput, humanSummary, stripOutputFlags, writeEnvelope } from "
 import { beginUsage, completeUsage, recordUsageOutput, usageReport } from "./usage-log.js";
 import { artifactFetchHint, artifactRoot, boundResult, emitInvalid, emitResult, emitTransportResult, outputBudget, readArtifact, withTransport, } from "./command-transport.js";
 import { CLI_DEFAULT_OUTPUT_BYTES, assertSafeOutputPath, pruneArtifacts } from "./artifacts.js";
-import { resolve } from "node:path";
+import { projectJsonPath, projectResultExtract } from "./path-projection.js";
+import { basename, join, resolve } from "node:path";
 import { buildToolRegistry } from "./tools.js";
 import { acquireWriteLock } from "./write-lock.js";
 import { cmdCompute } from "./compute.js";
@@ -274,12 +275,19 @@ async function cmdCall(store, args) {
     const positional = args.filter((token, index) => !token.startsWith("--") && (index === 0 || !args[index - 1]?.startsWith("--env") && !args[index - 1]?.startsWith("--environment") && !args[index - 1]?.startsWith("--args")));
     const toolName = positional[0];
     if (!toolName || toolName === "help" || args.includes("--help")) {
-        console.error("用法：omc call <tool> [--env <环境>] [--args '<json>' | --args - (stdin) | --args-file <path>]");
+        console.error("用法：omc call <tool> [--env <环境>] [--args '<json>' | --args - (stdin) | --args-file <配置根内路径>] [--extract <path>]... [--extract-keys]");
         console.error("写入：由环境 writable 决定（只读环境拒写）；生产环境的写必须在 args 里带 confirmProduction:true。");
         return emit(toolName && toolName !== "help" ? "error" : "ok", {}, toolName && toolName !== "help" ? CLI_EXIT_CODES.invalidInput : 0);
     }
     const environment = flag("--env") ?? flag("--environment");
     const requestValue = flag("--request-id");
+    // 1.2 of issue 2026-10-23: read faces answer {detailArtifactId, sha256} and the
+    // caller then needs a SECOND call to see one value (16 two-step chains in one
+    // session; 15 more were pure --keys probes). `--extract <path>` (repeatable)
+    // resolves the path inside the artifact of THIS result and returns only the
+    // value; `--extract-keys` lists the artifact's top-level keys with sizes.
+    const extractPaths = argvValues(args, "--extract");
+    const extractKeys = args.includes("--extract-keys");
     const dryRun = args.includes("--dry-run");
     const waitValue = flag("--wait");
     let waitMs = 0;
@@ -327,8 +335,26 @@ 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 configRoot = resolve(process.env.OMC_CONFIG_HOME ?? process.cwd());
+        // 1.1 of issue 2026-10-23: the old hint told the caller to write a TEMP file
+        // while the validator only accepts paths under the config root — the two
+        // instructions contradicted each other and neither named the root. Offer a
+        // single executable recipe: an absolute path inside the root.
+        const outOfRoot = /must be inside the configuration root/.test(detail);
+        const message = outOfRoot
+            ? `--args-file 越界：${detail}。可执行做法：把参数文件放到 ${configRoot} 之下（如 ${join(configRoot, "args.json")}），再用 --args-file 引用；不要把参数文件放在系统临时目录（配置根之外一律拒绝）`
+            : `--args 必须是合法 JSON：${detail}。若问题在引号转义（Windows PowerShell），改用 --args-file <配置根内的路径>`;
+        console.error(message);
+        // The MACHINE envelope must carry the same actionable text: agents read
+        // stdout, and the old envelope only repeated the English detail.
+        // Keep the REJECTED path on stderr only: the machine envelope must not leak
+        // host layout (ticket 103), so it carries the root plus the bare file name.
+        const rejectedName = typeof argsFile === "string" ? basename(resolve(configRoot, argsFile)) : "";
+        writeEnvelope(envelope("error", {}, request, { code: "invalid-input", message: outOfRoot ? `--args-file 必须位于配置根内（配置根 ${configRoot}${rejectedName ? `；本次文件 ${rejectedName}` : ""}）` : detail, retryable: false, ...(outOfRoot ? { configurationRoot: configRoot } : {}) }));
         return CLI_EXIT_CODES.invalidInput;
     }
     const registry = buildToolRegistry();
@@ -397,9 +423,26 @@ async function cmdCall(store, args) {
                 await lock.release();
         }
     }
+    if (extractPaths.length > 0 || extractKeys) {
+        const projected = projectResultExtract(result, extractPaths, extractKeys);
+        if (projected !== undefined)
+            result = projected;
+    }
     const classified = classifyResult(result);
     return emit(classified.status, result, classified.exitCode);
 }
+/** Collect every value of a repeatable flag (`--extract a --extract b`). */
+function argvValues(args, name) {
+    const values = [];
+    for (let index = 0; index < args.length; index += 1) {
+        if (args[index] !== name)
+            continue;
+        const value = args[index + 1];
+        if (value !== undefined && !value.startsWith("--"))
+            values.push(value);
+    }
+    return values;
+}
 function resolvedDefaultEnvironment(store) {
     try {
         return store.resolveEnvironment(undefined).name;
@@ -408,36 +451,6 @@ function resolvedDefaultEnvironment(store) {
         return "default";
     }
 }
-function projectJsonPath(value, path) {
-    const normalized = path
-        .trim()
-        .replace(/^[.\/]+/, "")
-        .replace(/\[(\d+)\]/g, ".$1")
-        .replace(/\[(?:"([^"]+)"|'([^']+)')\]/g, (_all, dq, sq) => `.${dq || sq}`)
-        .replace(/\.{2,}/g, ".");
-    const segments = normalized.split(/[./]/).filter((segment) => segment.length > 0);
-    let current = value;
-    for (const segment of segments) {
-        if (Array.isArray(current)) {
-            const index = Number(segment);
-            if (!Number.isInteger(index) || index < 0 || index >= current.length)
-                return { missed: true, at: segment, available: `数组长度 ${current.length}（下标 0-${Math.max(current.length - 1, 0)}）` };
-            current = current[index];
-        }
-        else if (current && typeof current === "object") {
-            const record = current;
-            if (!Object.prototype.hasOwnProperty.call(record, segment)) {
-                const keys = Object.keys(record);
-                return { missed: true, at: segment, available: keys.length > 0 ? keys.slice(0, 12) : "（该层是空对象）" };
-            }
-            current = record[segment];
-        }
-        else {
-            return { missed: true, at: segment, available: `路径在第 ${segments.indexOf(segment) + 1} 段之前已到标量/undefined（前段类型 ${current === null ? "null" : typeof current}）` };
-        }
-    }
-    return { missed: false, value: current };
-}
 function parseDurationMs(text) {
     const match = /^\s*(\d+)\s*(ms|s|m|h|d|w)?\s*$/u.exec(text);
     if (!match)
@@ -943,11 +956,47 @@ function onboardingHelp() {
     return [
         "首次使用、或不确定从哪开始：omc help omc-start-here（随包权威 topic 路线）；被拒或状态异常：omc help omc-refusals。",
         "目标→工具一步定位：omc next \"<你要做什么>\"（离线、只读，给能力/说明/首批命令；不确定会明说并回退到 omc-requirement-analysis）。",
+        "大结果取值一步到位：读面回 detailArtifactId 时，用 omc call <tool> … --extract <path>（可重复）或 --extract-keys，省掉再跑一次 omc artifact get。",
         "工具发现：omc commands --json（含 capability id/lane/recipes；加 --compact 只回工具行、无目录散文）· omc capabilities（能力 id/lane/aliases/tools/依赖顺序）· omc capability <id> --executable（单能力完整执行包）。",
         "单工具/契约：omc describe <tool>（schema+recipe+能力路由）· omc contract <lane>（wire 契约+能力路由）；环境就绪：omc call discover_environment --env <env> --args '{}'。",
         "写入两道门：对话层草稿确认（omc help omc-config-draft-review）+ 环境 writable 开关；生产环境每笔写需在 args 里带 confirmProduction:true。",
     ].join("\n");
 }
+/** Last command-level failure, so the no-envelope fallback can name the cause. */
+let lastFailureDetail;
+function failureDetail() {
+    return process.env.OMC_LAST_FAILURE ?? lastFailureDetail;
+}
+/**
+ * 1.5 of issue 2026-10-23: a `--jq` expression containing spaces/pipes arrives as
+ * multiple argv entries when the caller's shell splits it. Commander then
+ * answers "too many arguments for 'get'" — an arity complaint, not a quoting
+ * hint. Re-join the value before parsing.
+ */
+function joinSplitFlagValues(raw, flags) {
+    const out = [];
+    for (let index = 0; index < raw.length; index += 1) {
+        const token = raw[index];
+        if (!flags.includes(token)) {
+            out.push(token);
+            continue;
+        }
+        const value = raw[index + 1];
+        if (value === undefined) {
+            out.push(token);
+            continue;
+        }
+        const parts = [value];
+        let cursor = index + 2;
+        while (cursor < raw.length && !raw[cursor].startsWith("--")) {
+            parts.push(raw[cursor]);
+            cursor += 1;
+        }
+        out.push(token, parts.join(" "));
+        index = cursor - 1;
+    }
+    return out;
+}
 async function main() {
     let commandExitCode = 0;
     beginUsage(argv);
@@ -1031,8 +1080,8 @@ async function main() {
         commandExitCode = CLI_EXIT_CODES.ok;
     });
     command.command("doctor").option("--environment <environment>").option("--env <environment>").option("--service <serviceCode>", "可选：体检单个业务集成服务的鉴权参数形状（掩码/占位/全 0 检出，WARN 非致命）").action(async (options) => { commandExitCode = await cmdDoctor(new ConfigStore(defaultPaths()), options.environment ?? options.env, options.service); });
-    command.command("call <tool>").option("--env <environment>").option("--environment <environment>").option("--args <json>").option("--args-file <path>").option("--max-output-bytes <bytes>").option("--request-id <requestId>").option("--timeout-ms <milliseconds>").option("--wait <milliseconds>").option("--dry-run").addHelpText("after", `\n${onboardingHelp()}\n`).action(async (tool, options) => {
-        const rest = [tool, ...(options.env ? ["--env", options.env] : []), ...(options.environment ? ["--environment", options.environment] : []), ...(options.args !== undefined ? ["--args", options.args] : []), ...(options.argsFile !== undefined ? ["--args-file", options.argsFile] : []), ...(options.maxOutputBytes !== undefined ? ["--max-output-bytes", options.maxOutputBytes] : []), ...(options.requestId ? ["--request-id", options.requestId] : []), ...(options.timeoutMs !== undefined ? ["--timeout-ms", options.timeoutMs] : []), ...(options.wait !== undefined ? ["--wait", options.wait] : []), ...(options.dryRun ? ["--dry-run"] : [])];
+    command.command("call <tool>").option("--env <environment>").option("--environment <environment>").option("--args <json>").option("--args-file <path>").addOption(new Option("--extract <path>", "在本次结果的 artifact 内取一个路径的值（可重复；省掉一次 artifact get）").argParser((value, previous = []) => [...previous, value]).default([])).option("--extract-keys", "列出本次结果 artifact 的顶层键与体积（省掉一次 artifact get --keys）").option("--max-output-bytes <bytes>").option("--request-id <requestId>").option("--timeout-ms <milliseconds>").option("--wait <milliseconds>").option("--dry-run").addHelpText("after", `\n${onboardingHelp()}\n`).action(async (tool, options) => {
+        const rest = [tool, ...(options.env ? ["--env", options.env] : []), ...(options.environment ? ["--environment", options.environment] : []), ...(options.args !== undefined ? ["--args", options.args] : []), ...(options.argsFile !== undefined ? ["--args-file", options.argsFile] : []), ...(Array.isArray(options.extract) ? options.extract.flatMap((path) => ["--extract", path]) : []), ...(options.extractKeys ? ["--extract-keys"] : []), ...(options.maxOutputBytes !== undefined ? ["--max-output-bytes", options.maxOutputBytes] : []), ...(options.requestId ? ["--request-id", options.requestId] : []), ...(options.timeoutMs !== undefined ? ["--timeout-ms", options.timeoutMs] : []), ...(options.wait !== undefined ? ["--wait", options.wait] : []), ...(options.dryRun ? ["--dry-run"] : [])];
         commandExitCode = await cmdCall(new ConfigStore(defaultPaths()), rest);
     });
     command.command("compute").option("--schema <schemaCode>").option("--schema-code <schemaCode>").option("--target <propertyCode>").option("--property <propertyCode>").option("--formula <formula>").option("--name <name>").option("--env <environment>").option("--environment <environment>").option("--apply").addHelpText("after", "\n字段计算规则拼装器：公式 {字段} 引用 → datarule type2 完整形状（editorText/editorMark 自动生成）。默认 dry-run，--apply 写入。复杂场景（条件分支/跨模型）走 omc next 的 recipe 路径。\n").action(async (options) => {
@@ -1154,7 +1203,8 @@ async function main() {
     intentCommand.command("readback <file>").option("--env <environment>").option("--max-output-bytes <bytes>").action(async (file, options) => {
         commandExitCode = await withTransport(options, request, (transport) => cmdIntentReadback(file, options.env, transport));
     });
-    await command.parseAsync(stripOutputFlags(argv));
+    // `--jq` expressions the shell split arrive as several tokens; re-join them.
+    await command.parseAsync(joinSplitFlagValues(stripOutputFlags(argv), ["--jq"]));
     return commandExitCode;
 }
 /**
@@ -1174,12 +1224,28 @@ 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;
     }
-    writeEnvelope(envelope(code === 0 ? "ok" : "error", {}, request, code === 0 ? null : { code: "internal", message: "command failed", retryable: false }));
+    // 1.6 of issue 2026-10-23: a bare "command failed" gives no stage and no cause.
+    writeEnvelope(envelope(code === 0 ? "ok" : "error", {}, request, code === 0
+        ? null
+        : {
+            code: "internal",
+            message: `${argv[2] ?? "omc"} 以退出码 ${code} 结束但没有写出结果信封${failureDetail() ? `：${failureDetail()}` : "（没有捕获到具体异常；加 --verbose 复现，或用相同参数再跑一次看 stderr）"}`,
+            retryable: false,
+            ...(failureDetail() ? { stage: "post-command" } : {}),
+        }));
     completeUsage(code);
     finish(code);
 }, (error) => {

package/dist/command-transport.js

@@ -82,7 +82,7 @@ export function artifactFetchHint(artifactId) {
     // raw. `--summary` shows the key/size map so they fetch only what they need.
     // Kept terse on purpose: this line rides EVERY write and every spilled read
     // (2026-09-25 cost pass — the parenthetical prose was 80 B of the 133 B).
-    return `omc artifact get ${artifactId} --summary（再 --keys/--jq）`;
+    return `omc artifact get ${artifactId} --summary（再 --keys/--jq）；或原调用加 --extract <path> / --extract-keys 一次拿到`;
 }
 /** Replace local paths with a redaction marker (never leak the host layout). */
 function sanitizePaths(value) {

package/dist/compute.js

@@ -74,9 +74,10 @@ export async function cmdCompute(args) {
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
+        process.env.OMC_LAST_FAILURE = `compute → datarule.create: ${message}`;
         writeEnvelope(envelope("error", {}, request, {
             code: "compute-write-failed",
-            message: `compute 调用 datarule.create 失败：${message}\n` +
+            message: `compute 调用 datarule.create 失败（stage=datarule.create）：${message}\n` +
                 "若 --schema 是**子表 code**（子表列计算），改用可跑样例直接发：omc describe datarule.create --example field-compute-child-column，" +
                 "或 omc call datarule.create --args '<该样例 args>'（含 resultType/formulaType/expression 的嵌套 JSON）。",
             retryable: false,

package/dist/discovery.js

@@ -200,11 +200,29 @@ export function describeTool(registry, name) {
         // of a 133 KB task even though a matching recipe existed.
         ...(hasRecipe ? { exampleHint: `可运行参数用 --example <id>（~1–2KB）；单参数用 --param <name>；仅当二者都缺形状才 --full` } : {}),
         ...(!hasRecipe ? { exampleHint: `无静态 recipe：required + params 已够常规调用；单参数说明用 --param <name>；仅当需要全部参数注释/拒绝形状才 --full（5–20KB）` } : {}),
+        // 1.7 of issue 2026-10-23: the parameter DOC for `subFields` was only
+        // reachable through --param/--full, i.e. discovering a param needed its
+        // name first. Name the documented params inline (cheap: names only) so one
+        // `describe` answers "does this tool take X, and what is X called".
+        ...(documentedParamNames(tool).length > 0
+            ? { paramDocs: { available: documentedParamNames(tool), read: `omc describe ${tool.name} --param <name>（单个参数注释，几百字节）` } }
+            : {}),
         // Keep the cost salient at the decision point: agents reached for --full even
         // when --example/--param existed (sandbox22: 8 --full calls, one 19 KB).
         full: `omc describe ${tool.name} --full（5–20KB；先试 --example/--param）`,
     };
 }
+/** Param names whose schema entry carries a `.describe()` (documented params). */
+function documentedParamNames(tool) {
+    const shape = (tool.inputSchema ?? {});
+    const names = [];
+    for (const [key, value] of Object.entries(shape)) {
+        const description = value?.description;
+        if (typeof description === "string" && description.trim() !== "")
+            names.push(key);
+    }
+    return names.sort();
+}
 /** `omc describe <tool> --example <id>`: one recipe in full, by id. */
 export function describeExample(registry, name, exampleId) {
     const tool = registry.find((entry) => entry.name === name);

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);

package/dist/form-layout.js

@@ -14,6 +14,23 @@
  */
 export const ALLOWED_SPANS = new Set([6, 8, 12, 16, 18, 24]);
 export const FULL_SPAN = 24;
+/**
+ * 1.3 of issue 2026-10-23: these three classifications describe shapes the
+ * PLATFORM ITSELF stores — its default scaffold puts creater/createdTime/
+ * sequenceNo on one row (each defaulting to span 24 → "overflow"), and some
+ * published layouts list child columns as rows. Refusing them makes a
+ * read→write round-trip impossible, so they are warnings, not blockers.
+ * Coverage/span/options/type violations stay hard.
+ */
+export const SOFT_LAYOUT_CLASSIFICATIONS = new Set();
+// No classification is unconditionally soft: a caller-authored bad layout must
+// still refuse with ZERO wire. The platform's own readback is tolerated by
+// `form.draft`'s `fromReadback` path instead (issue 2026-10-23 §1.3), where the
+// supplied faces can be compared against the stored sheet. The default-width
+// row rule below still keeps the platform's scaffold rows from tripping.
+export function hardLayoutViolations(violations) {
+    return violations.filter((violation) => !SOFT_LAYOUT_CLASSIFICATIONS.has(violation.classification));
+}
 /** Child-table (Sheet 201) column keys, which must live on `columns`, never in rows. */
 function childColumnKeys(attrs) {
     const keys = new Set();
@@ -99,10 +116,16 @@ export function validateFormLayout(rows, attributes) {
         const codes = row.map((code) => String(code));
         const widths = codes.map((code) => spanOf(attrs, code, violations));
         const total = widths.reduce((sum, width) => sum + width, 0);
-        if (total > FULL_SPAN) {
+        // The platform's OWN scaffold writes rows like creater+createdTime+
+        // sequenceNo with NO explicit span (each defaults to 24) — rows made only of
+        // default-width system controls are the platform's shape, not a caller
+        // error (issue 2026-10-23 §1.3). Only a row that sets a span explicitly is
+        // judged by the width rules.
+        const hasExplicitSpan = codes.some((code) => attrs[code]?.options !== undefined && (attrs[code]?.options).span !== undefined);
+        if (hasExplicitSpan && total > FULL_SPAN) {
             violations.push({ classification: "layout_row_overflow", row: index + 1, message: `第 ${index + 1} 行 span 合计 ${total}，超过 ${FULL_SPAN}（${codes.join(" + ")}）` });
         }
-        if (codes.length !== 1 && widths.some((width) => width === FULL_SPAN)) {
+        if (hasExplicitSpan && codes.length !== 1 && widths.some((width) => width === FULL_SPAN)) {
             violations.push({ classification: "full_row_control_conflict", row: index + 1, message: `第 ${index + 1} 行含整行控件（span=24），不能与其他控件同行（${codes.join(" + ")}）` });
         }
     });