@stalfh233/omc-cli 0.5.7 → 0.5.8

package/dist/field-add.js

@@ -17,6 +17,70 @@ import { argvValue } from "./args.js";
 import { runToolCall } from "./call.js";
 import { CLI_EXIT_CODES, classifyResult, envelope, refusalText, requestId } from "./cli-contract.js";
 import { writeEnvelope } from "./cli-output.js";
+/**
+ * 字典简写展开（r30/r36 实证：字典字段要先 names 查 id、records 取记录、
+ * 再拼 optionsSet.dictionary 三段 4–5 调；`dictCode` 把它折进 field-add 一步）：
+ * `{"code":"x","propertyType":"DROPDOWN_BOX","dictCode":"purchase_coop_status"}`
+ * → 内部解析 checkedDictionary(id)+checkedDictionaryCode+useDictionariesData(records)
+ * 按 dictionary-backed-single-select recipe 形状组装 options.optionsSet。
+ */
+async function expandDictShorthand(fields, environment, contextForTest, request) {
+    const problems = [];
+    const expanded = [];
+    const call = async (tool, args) => {
+        const outcome = await runToolCall(tool, {
+            args,
+            requestId: request,
+            ...(environment !== undefined ? { environment } : {}),
+            ...(contextForTest !== undefined ? { context: contextForTest } : {}),
+            print: () => undefined,
+        });
+        return outcome.exitCode === 0 ? outcome.result : null;
+    };
+    const out = [];
+    for (const field of fields) {
+        const dictCode = field.dictCode;
+        if (typeof dictCode !== "string" || dictCode.length === 0) {
+            out.push({ ...field });
+            continue;
+        }
+        const rest = { ...field };
+        delete rest.dictCode;
+        // dictionary.list 是真假两平台都稳的清单面（names 的 getDictionaryIdAndNames
+        // 在 fake 上未实现）；list 的回执可能是 {dictionaries:{content:[...]}} 分页
+        // 或裸数组，两种都吃。
+        const listResult = await call("dictionary.list", { limit: 200 });
+        const listPayload = listResult === null ? null : (listResult.dictionaries ?? listResult.names ?? listResult.content ?? listResult);
+        const names = Array.isArray(listPayload)
+            ? listPayload
+            : (Array.isArray(listPayload?.content) ? listPayload.content : []);
+        const hit = names.find((row) => String(row.code ?? row.dictionaryCode ?? "") === dictCode);
+        if (hit === undefined) {
+            problems.push(`${String(field.code)}: 字典 ${dictCode} 不存在（dictionary.names 未命中）——先 dictionary.save 或修正 dictCode`);
+            continue;
+        }
+        const dictId = String(hit.id ?? hit.dictionaryId ?? "");
+        const recordsResult = await call("dictionary.records", { code: dictCode, enabledOnly: true });
+        const recordsRaw = recordsResult === null ? [] : (recordsResult.records ?? {});
+        const recordRows = (Array.isArray(recordsRaw) ? recordsRaw : (recordsRaw.content ?? []));
+        if (recordRows.length === 0) {
+            problems.push(`${String(field.code)}: 字典 ${dictCode} 无启用记录——先补 dictionary.records`);
+            continue;
+        }
+        const useDictionariesData = recordRows.map((row) => ({ id: String(row.id ?? ""), code: String(row.code ?? ""), name: String(row.name ?? row.code ?? "") }));
+        out.push({
+            ...rest,
+            options: {
+                optionsSet: {
+                    optionsType: "dictionary",
+                    dictionary: { checkedDictionary: dictId, checkedDictionaryCode: dictCode, useDictionariesData },
+                },
+            },
+        });
+        expanded.push(String(field.code));
+    }
+    return { fields: out, expanded, problems };
+}
 export function validateFields(schemaCode, fields) {
     const problems = [];
     const seen = new Set();
@@ -52,7 +116,8 @@ export async function cmdFieldAdd(args, contextForTest) {
     const forcePublish = args.includes("--force-publish");
     const usage = [
         "用法：omc field-add --schema <模型code> --fields '<JSON 数组>' [--apply]",
-        "  --fields 每项是一个 field.create 的参数：{\"code\",\"name\",\"propertyType\",...}（choices/字典 options 原样透传）。",
+        "  --fields 每项是一个 field.create 的参数：{\"code\",\"name\",\"propertyType\",...}（choices/字典 options 原样透传）；",
+        "  字典简写：{\"dictCode\":\"<字典code>\"} 代替手拼 options.optionsSet（内部解析字典 id+启用记录，recipe 同形状）。",
         "  默认 dry-run；--apply 依次执行 建字段 → 发布字段 → 重建表单 → 列表追加列。",
         "  幂等：字段已存在记 skipped 继续；有真失败默认不发布/不重建（--force-publish 强发）。",
         "  --no-form 跳过表单重建；--no-list 跳过列表加列（默认两者都做）。",
@@ -78,6 +143,16 @@ export async function cmdFieldAdd(args, contextForTest) {
     const problems = validateFields(schemaCode, fields);
     if (problems.length > 0)
         return invalid(`--fields 有 ${problems.length} 处问题：\n  - ${problems.join("\n  - ")}`);
+    // 字典简写展开（dictCode → optionsSet.dictionary，含 id/记录解析）——展开失败
+    // 在任何写之前拒绝（名字对不上/无启用记录）。
+    let dictExpanded = 0;
+    if (fields.some((field) => typeof field.dictCode === "string")) {
+        const expandedResult = await expandDictShorthand(fields, environment, contextForTest, request);
+        if (expandedResult.problems.length > 0)
+            return invalid(`dictCode 展开失败（未写入）：\n  - ${expandedResult.problems.join("\n  - ")}`);
+        fields = expandedResult.fields;
+        dictExpanded = expandedResult.expanded.length;
+    }
     const options = {
         schemaCode, fields, apply, publishForm, addToList, forcePublish,
         ...(environment !== undefined ? { environment } : {}),
@@ -115,6 +190,7 @@ export async function cmdFieldAdd(args, contextForTest) {
             status: "dry-run",
             schema: schemaCode,
             fields: fields.map((field) => String(field.code)),
+            ...(dictExpanded > 0 ? { dictExpanded } : {}),
             steps: [
                 `field.create ×${fields.length}`,
                 "field.publish（发布失败/有字段失败则停）",

package/dist/form-support.js

@@ -1147,6 +1147,15 @@ export async function executeFormDraftWrite(session, args) {
                 }
                 : {}),
             ...(args.rebuild === true && previousAttributes ? { rebuildPreservedControls } : {}),
+            // r36（2026-11-01）：rebuild 后草稿与重建前逐字节一致时明示——rebuild 的
+            // 语义就是"按已发布字段重搭"，一致通常意味着预期的新控件没进来（字段未
+            // 发布/写错槽位），静默 no-op 会让"新增字段后刷新表单"看起来成功实则没变。
+            ...(args.rebuild === true && previousAttributes !== undefined && typeof attributes === "string" && attributes.trim() === JSON.stringify(previousAttributes).trim()
+                ? {
+                    rebuildUnchanged: true,
+                    rebuildNote: "rebuild 后草稿与重建前完全一致——若你预期新增控件（新字段上表单），检查：① 字段是否已 field.publish；② 写入槽位 sheetCode 是否正确（省略=模型 code 槽位）；r36 实测同序列下重建静默 no-op。",
+                }
+                : {}),
         },
     };
 }

package/dist/human-summary.js

@@ -126,7 +126,7 @@ function phraseOf(tool, args, outcome) {
         case "field.publish":
             return `发布模型 ${schemaCode ?? "?"} 的全部草稿字段（模型级一次发布）`;
         case "form.draft":
-            return `保存表单 ${stringArg(args, "sheetCode") ?? "?"}（模型 ${schemaCode ?? "?"}）的草稿布局`;
+            return `保存表单 ${stringArg(args, "sheetCode") ?? (schemaCode !== undefined ? String(schemaCode) : "?")}（模型 ${schemaCode ?? "?"}）的草稿布局——sheetCode 省略时实际写入 = 模型 code 槽位`;
         case "form.publish":
             // r26 finding: sheetCode is optional (resolved from schemaCode for the
             // default form) — the summary showed "?" when the agent omitted it.

package/dist/path-projection.js

@@ -2,6 +2,24 @@ import { readFileSync } from "node:fs";
 import { readArtifact } from "./artifacts.js";
 import { artifactRoot } from "./command-transport.js";
 export function projectJsonPath(value, path) {
+    // 2026-11-01（r36 维护者实测）：jq 切片 `a[0:6]`/`a[:n]`/`a[n:]` 此前
+    // pathMiss 且 hint 的 available 还把数组列成"可用键"，误导下一步。数组
+    // 切片与 jq 语义一致（含头不含尾）。
+    const sliceSel = /\[(\d*):(\d*)\]/.exec(path);
+    if (sliceSel !== null) {
+        const [, rawFrom, rawTo] = sliceSel;
+        const before = path.slice(0, sliceSel.index);
+        const after = path.slice(sliceSel.index + sliceSel[0].length);
+        const base = projectJsonPath(value, before);
+        if (base.missed)
+            return base;
+        if (!Array.isArray(base.value))
+            return { missed: true, at: before || "$", available: `该层不是数组（是 ${base.value === null ? "null" : typeof base.value}）；切片 [from:to] 需要数组` };
+        const from = rawFrom === "" ? undefined : Number(rawFrom);
+        const to = rawTo === "" ? undefined : Number(rawTo);
+        const sliced = base.value.slice(from, to);
+        return after === "" ? { missed: false, value: sliced } : projectJsonPath(sliced, after);
+    }
     // 1.5 of issue 2026-10-23: an array-of-objects selection WITHOUT jq pipes.
     // `.rules[code=Create]` (or `[code="Create"]`) picks the FIRST element whose
     // key matches — exactly the shape callers reached for with
@@ -97,7 +115,7 @@ function argvValues(args, name) {
     return values;
 }
 /** Shared wording for every projection miss, so all three faces teach the same syntax. */
-const PATH_MISS_HINT = "路径未命中（这一层没有该段）。可用写法：点式 a.b、下标 a[0]、数组映射 items[].fields.x、按键选择 rules[code=Create]（返回第一个匹配项）。available 是该层真实存在的键。";
+const PATH_MISS_HINT = "路径未命中（这一层没有该段）。可用写法：点式 a.b、下标 a[0]、切片 a[0:6]、数组映射 items[].fields.x、按键选择 rules[code=Create]（返回第一个匹配项）。available 是该层真实存在的键。";
 /**
  * `call --extract/--extract-keys`: resolve paths inside the result's own
  * artifact (or inside the result object when the tool returned no artifact).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stalfh233/omc-cli",
-  "version": "0.5.7",
+  "version": "0.5.8",
   "description": "CloudPivot 8.6 configuration capability CLI — governed, fail-closed, coverage-manifest bounded.",
   "type": "module",
   "bin": {
@@ -52,9 +52,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@stalfh233/omc-fake-platform": "0.5.7",
+    "@stalfh233/omc-fake-platform": "0.5.8",
     "commander": "14.0.3",
-    "omc-core": "0.5.7",
+    "omc-core": "0.5.8",
     "proper-lockfile": "4.1.2",
     "write-file-atomic": "6.0.0",
     "zod": "^3.23.8",

package/skills/omc-capabilities.md

@@ -68,7 +68,7 @@ only the section for the capability you need —
 - **能做哪些事**：字典与字典记录全生命周期（键值型/树型、启停）；作为选择字段的选项来源；字典分类。
 - **工具**：`dictionary.list`、`dictionary.type`、`dictionary.names`、`dictionary.get`、`dictionary.records`、`dictionary.save`、`dictionary.status`、`dictionary.usage`、`dictionary.parent`、`dictionary.classes`、`dictionary.class.save`、`dictionary.class.delete`
 - **recipe**：`omc describe dictionary.save --example dictionary-key-value`
-- **边界 / 陷阱**：选择字段有三种选项来源——`custom` / `dictionary` / `businessModel`；关联单选/多选支持 `searchFormula` 与 `conditions` JSON 筛选。
+- **边界 / 陷阱**：选择字段有三种选项来源——`custom` / `dictionary` / `businessModel`；关联单选/多选支持 `searchFormula` 与 `conditions` JSON 筛选。**字典没有删除**——平台只有停用/启用（`dictionary.status`，target= dictionary|record）；不要找 dictionary.delete（分类有 `class.delete`，字典本体没有），清理测试残留用停用即可。
 
 ## 业务模型 `model`
 

package/skills/omc-start-here.md

@@ -12,7 +12,7 @@ be treated as a second source. Read this, then follow the topics it names.
 
 ## 最小路径（先读这段就能开始）
 
-0. **调用与检索（跨平台）**：`omc call ... --args '<json>'` 的内联 JSON 在 Windows PowerShell 下因引号转义不可靠——**PS 环境优先 `--args-file <path>`**（把 JSON 写临时文件再引用；解析失败的报错里也有此提示）。读命令输出默认把中文转义为 `\uXXXX`（防乱码）——**对输出做内容检索前先加 `--utf8`（单次明文）或先解 JSON，"grep 搜不到中文"≠"没有配置"**（静默假阴性坑）。**stdout 恒为纯 JSON 信封，人读进度（「已执行 xxx」等）走 stderr**——脚本解析别 `2>&1` 合流（r33/r34 两轮探针同坑），合流后从首个 `{` 截断。
+0. **调用与检索（跨平台）**：`omc call ... --args '<json>'` 的内联 JSON 在 Windows PowerShell 下因引号转义不可靠——**PS 环境优先 `--args-file <path>`**（把 JSON 写临时文件再引用；解析失败的报错里也有此提示）。读命令输出默认把中文转义为 `\uXXXX`（防乱码）——**对输出做内容检索前先加 `--utf8`（单次明文）或先解 JSON，"grep 搜不到中文"≠"没有配置"**（静默假阴性坑）。stdout 恒为纯 JSON、人读进度在 stderr——脚本解析勿 `2>&1` 合流。
 
 0. **拼装器优先（高频写面一条命令）**：整模型建模（模型+N 字段+子表+发布+表单）`omc model-scaffold`；**存量模型加字段（建→发布→重建表单→列表加列）`omc field-add`**；字段计算 `omc compute`；条件→动作 `omc rule-when`；线性审批流 `omc approval-flow`；表单默认值 `omc form-default`；存量盘点 `data.list all:true`——命中这些形态先看 `--help`，比 recipe 手拼省 10+ 轮。
 0c. **清理一个模型用 `omc model-purge --code <x> [--purge-instances] --apply`**——按依赖倒序（实例 → 模型级联带走流程/视图/字段/表单），**不要手工逐层删**：删部门/字段留下缓存或孤儿，会让后续调用出现「假 40009 / 假孤儿 / 全局待办 50000」这类幽灵故障（r12–r14 三次实测）。若返回 `unremovableInstances`（业务对象已删的停滞实例，平台 `delete_instance` NPE），按返回的 `maintainerAction` 让维护者清 `biz_workflow_instance`；**不要改用 model.delete 硬来**。

package/skills/omc-write-hazards.md

@@ -190,15 +190,15 @@ omc call field.publish --env local --args '{"schemaCode":"expense"}'
 
 - `workitem.list` 只回**当前登录人**的待办：审批人配别人 → 看不到待办，`data.submit` 被 `submit-workitem-not-mine` 拒（40005）。演示闭环要么节点参与者用 `{Originator}`，要么把登录人加进审批角色。
 - **`org.role.addUsers` 必须紧跟 `org.role.setUserScope`**：只加成员不布作用域，平台不报错（仅 `org-role-member-scope-empty` 警告），但成员**无法被流程解析为参与人**。一对调用别做半。
-- **`transferDepartment` 迁人不迁作用域**（r33 真机）：用户换部门后 `role.userScope` 仍指旧部门——成员随人走、作用域不随人走；迁移后按业务复核各成员作用域。
-- **`user.delete` 是软删**（r33 真机）：回 `deleted:true` 但 `user.info` 仍 `exists:true`（`userStatus:DISABLE`）、部门树也可能仍见节点——验证口径用「列表/状态」，别声称物理清除。
+- **`transferDepartment` 迁人不迁作用域**（r33 真机）：换部门后 `role.userScope` 仍指旧部门——迁移后复核成员作用域。
+- **`user.delete` 是软删**（r33 真机）：回 `deleted:true` 但 `user.info` 仍 `exists:true`（DISABLE）——验证口径用列表/状态，别称物理清除。
 - **「名称重复 200001」≠ 失败**（r33 真机）：多为首次已建成、重发才撞重复——先读回确认首建结果再决定。
+- **删模型≠删干净（收藏夹死引用）**（2026-11-01 真机）：模型删除后用户收藏（`h_user_favorites`，含 `_wf` 变体）与 h_biz_property/query/sheet/data_rule/button/method_mapping 等行残留——之后**每次**数据读写都在 launcher 日志抛 `appFunction not exist, schemaCode:<死模型>`（刷屏不阻断）。清理=按 schemaCode 关联删八表+收藏（维护者）；见此报错先查收藏夹。
 
 ## workflow.update 的行级替换语义（r32 真机 2026-10-31）
 
 - **`btnConfigList` 局部行=整行替换**：只传 `{code, remark}` 会把该按钮的 `enabled` 静默置 `false`、`commentPermission` 置 `null`（"驳回意见必填"丢失），同提交未提及的其他属性也被重置。改前先 `workflow.get_published`/`get_draft` 取整行，改目标属性后**整条回写**；`propertyPermissions` 同粒度。
-- 只改 `participant`/`btnConfigList` 的 activity 行**必须显式带 `type`**——省略 type 的豁免仅限带 `propertyPermissions` 的权限编辑行（拒绝信封已注明）。
-- **`SINGLE_PARTICIPANT` 配多角色只取第一个解析出的成员**（`MULTI_PARTICIPANT` 则全员会签）——演示/测试时"配置没生效"常是它；回读确认实际解析人。
+- **`SINGLE_PARTICIPANT` 多角色只取第一个解析成员**（MULTI 则全员会签）——"配置没生效"常是它，回读确认解析人。
 
 ## 跨表回写的真实语义（1.1.25 源码 + 真机 2026-10-20）