@stalfh233/omc-cli 0.5.0 → 0.5.1

package/dist/fake/workflow.js

@@ -0,0 +1,364 @@
+import { businessRefusal, malformedEnvelope, NOT_HANDLED } from "./state.js";
+const PENDING_STATES = new Set(["NOTSTARTED", "INPROGRESS"]);
+const ACTIVITY_TYPES = new Set(["START", "END", "CONNECTION", "PARTICIPANT", "SUB_INSTANCE", "CIRCULATE", "SYSTEM_ACTIVITY", "AGENT_ACTIVITY"]);
+const POINT = /^-?\d+(?:\.\d+)?,\s-?\d+(?:\.\d+)?$/;
+/**
+ * Live 8.6.26 fidelity (2026-09-17 probe): workflow/validate and /publish
+ * answer HTTP 200 + errcode 0 and put the truth in `data` as
+ * ValidateMessage[]. The originate (first PARTICIPANT) node's `participant`
+ * must be the platform keyword `"{Originator}"`; a plain value ("admin")
+ * answers `401035 <activityName> ERROR` and the flow never goes live.
+ * `"{Creator}"` on a non-originate participant node is a `401062` WARN that
+ * does not block.
+ */
+function validateWorkflowParticipants(activities) {
+    if (!Array.isArray(activities))
+        return [];
+    const rows = activities;
+    const participants = rows.filter((activity) => String(activity?.activityType ?? "") === "PARTICIPANT");
+    const messages = [];
+    const originate = participants[0];
+    if (originate && String(originate.participant ?? "") !== "{Originator}")
+        messages.push({ errCode: 401035, errContent: originate.activityName ?? originate.activityCode ?? "", errMsg: null, errorLevel: "ERROR" });
+    for (const activity of participants.slice(1)) {
+        if (String(activity.participant ?? "") === "{Creator}")
+            messages.push({ errCode: 401062, errContent: activity.activityName ?? activity.activityCode ?? "", errMsg: null, errorLevel: "WARN" });
+    }
+    return messages;
+}
+function invalidRenderShape(body) {
+    if (!Array.isArray(body.activities))
+        return "activities";
+    const codes = new Set();
+    for (const activity of body.activities) {
+        const record = activity;
+        const code = String(record?.activityCode ?? "").trim();
+        const type = String(record?.activityType ?? "").trim();
+        if (!code || codes.has(code) || !ACTIVITY_TYPES.has(type))
+            return "activities";
+        codes.add(code);
+    }
+    if (!Array.isArray(body.rules))
+        return "rules";
+    for (const rule of body.rules) {
+        const record = rule;
+        const pre = String(record?.preActivityCode ?? "");
+        const post = String(record?.postActivityCode ?? "");
+        const points = record?.points;
+        if (!codes.has(pre) || !codes.has(post) || !Array.isArray(points) || points.length === 0 || points.some((point) => typeof point !== "string" || !POINT.test(point)))
+            return "rules";
+    }
+    return null;
+}
+/**
+ * Spawn the two work items a workflow start produces: the originator fill item
+ * (already FINISHED — the start submit is the fill) and the pending approval
+ * item that `workitem.list` must surface for `data.submit`.
+ */
+export function startWorkflowInstance(state, input) {
+    const sequence = state.workItems.size + 1;
+    const instanceId = `wf-${sequence}`;
+    const fillId = `wi-${sequence}`;
+    const approveId = `wi-${sequence + 1}`;
+    state.workItems.set(fillId, {
+        id: fillId,
+        instanceId,
+        activityCode: "fill",
+        activityName: "填写申请单",
+        participant: "tester",
+        state: "FINISHED",
+        workflowCode: input.workflowCode,
+        schemaCode: input.schemaCode,
+        bizObjectId: input.bizObjectId,
+    });
+    state.workItems.set(approveId, {
+        id: approveId,
+        instanceId,
+        activityCode: "approve",
+        activityName: "审批",
+        participant: "tester",
+        state: "INPROGRESS",
+        workflowCode: input.workflowCode,
+        schemaCode: input.schemaCode,
+        bizObjectId: input.bizObjectId,
+    });
+    return { workflowInstanceId: instanceId, workItemId: approveId };
+}
+/** Complete a pending work item (approval submit). Returns false if unknown. */
+export function completeWorkItem(state, workItemId) {
+    const item = state.workItems.get(workItemId);
+    if (!item)
+        return false;
+    item.state = "FINISHED";
+    return true;
+}
+/**
+ * Portal draft-save shape (finishStart=FALSE): one instance in DRAFT with a
+ * single PENDING start work item. Submitting that item (startWorkflowDraft's
+ * workItemId) is what advances the instance — see startWorkflowInstance for
+ * the finishStart=TRUE twin.
+ */
+export function startWorkflowDraft(state, input) {
+    const sequence = state.workItems.size + 1;
+    const instanceId = `wf-${sequence}`;
+    const startId = `wi-${sequence}`;
+    state.workItems.set(startId, {
+        id: startId,
+        instanceId,
+        activityCode: "fill",
+        activityName: "填写申请单",
+        participant: "tester",
+        state: "INPROGRESS",
+        workflowCode: input.workflowCode,
+        schemaCode: input.schemaCode,
+        bizObjectId: input.bizObjectId,
+        isStart: true,
+    });
+    return { workflowInstanceId: instanceId, workItemId: startId };
+}
+/** After the START work item is submitted, the next (approval) activity spawns a pending todo. */
+export function spawnApprovalWorkItem(state, input) {
+    const approveId = `wi-${state.workItems.size + 1}`;
+    state.workItems.set(approveId, {
+        id: approveId,
+        instanceId: input.instanceId,
+        activityCode: "approve",
+        activityName: "审批",
+        participant: "tester",
+        state: "INPROGRESS",
+        workflowCode: input.workflowCode,
+        schemaCode: input.schemaCode,
+        bizObjectId: input.bizObjectId,
+    });
+    return approveId;
+}
+function toWorkItemVO(item) {
+    return {
+        id: item.id,
+        instanceId: item.instanceId,
+        activityCode: item.activityCode,
+        activityName: item.activityName,
+        state: item.state,
+        workflowCode: item.workflowCode,
+        schemaCode: item.schemaCode,
+        participant: item.participant,
+        participantName: item.participantName ?? item.participant,
+        originator: item.originator,
+        sequenceNo: item.sequenceNo,
+    };
+}
+/** W7-S29-greenfield lane: workflow template authoring + runtime work-item query. Twin of src/lanes/workflow.ts. */
+export const workflowRoute = (ctx, input) => {
+    const q = input.query ?? {};
+    const body = (input.body ?? {});
+    switch (input.path) {
+        case "/api/api/workflow/create": {
+            const code = String(body.workflowCode ?? body.code ?? "");
+            const name = String(body.workflowName ?? body.name ?? code);
+            const schemaCode = String(body.schemaCode ?? "");
+            // Ticket 76 live fidelity: creating a workflow when the SCHEMA already
+            // has one answers an envelope with NO numeric errcode (live:
+            // "envelope for /api/api/workflow/create has no numeric errcode") — the
+            // tool must decode it as a duplicate-create, not a malformed failure.
+            if ([...ctx.state.workflows.values()].some((wf) => wf.schemaCode === schemaCode) && !ctx.state.workflows.has(code))
+                return malformedEnvelope({ workflowCode: code, workflowName: name, schemaCode, exist: true });
+            if (!ctx.state.workflows.has(code)) {
+                // Ticket 112 platform fidelity: the real create auto-generates a
+                // full draft (START → PARTICIPANT 填写申请单 → END with canvas rules;
+                // WorkflowTemplateController update @ApiImplicitParam example) — the
+                // fake seeds the same platform-shaped template so the merge path has
+                // real activity boxes and rule shapes to echo.
+                ctx.state.workflows.set(code, {
+                    code,
+                    name,
+                    schemaCode,
+                    template: {
+                        workflowCode: code,
+                        name,
+                        workflowName: name,
+                        schemaCode,
+                        // Live create seeds templateType DRAFT ("SAVE" is not a
+                        // WorkflowTemplateStatus member — S29 contract).
+                        templateType: "DRAFT",
+                        activities: [
+                            { activityCode: "Activity1", activityType: "START", activityName: "开始", x: 327, y: 36, width: 158, height: 40 },
+                            { activityCode: "Activity2", activityType: "PARTICIPANT", activityName: "填写申请单", participant: "{Originator}", x: 327, y: 116, width: 158, height: 40 },
+                            { activityCode: "Activity3", activityType: "END", activityName: "结束", x: 327, y: 196, width: 158, height: 40 },
+                        ],
+                        rules: [
+                            { preActivityCode: "Activity1", postActivityCode: "Activity2", points: ["406, 76", "406, 116"] },
+                            { preActivityCode: "Activity2", postActivityCode: "Activity3", points: ["406, 156", "406, 196"] },
+                        ],
+                    },
+                    published: null,
+                });
+            }
+            return { code };
+        }
+        case "/api/api/workflow/isworkflow": {
+            // WorkflowTemplateController.isWorkFlow(schemaCode): any header for the
+            // schema answers true.
+            const schemaCode = String(q.schemaCode ?? "");
+            return [...ctx.state.workflows.values()].some((wf) => wf.schemaCode === schemaCode);
+        }
+        case "/api/api/workflow/getWorkflow": {
+            // WorkflowTemplateController.getWorkflow(schemaCode): the published
+            // template for the schema (carries workflowCode), or null when the model
+            // has none. Used to auto-start a workflow-backed data.submit.
+            const schemaCode = String(q.schemaCode ?? "");
+            const wf = [...ctx.state.workflows.values()].find((candidate) => candidate.schemaCode === schemaCode);
+            if (!wf)
+                return null;
+            const template = (wf.published ?? wf.template);
+            return { ...template, workflowCode: wf.code };
+        }
+        case "/api/api/workflow/get_header": {
+            const wf = ctx.state.workflows.get(String(q.workflowCode ?? ""));
+            // Round-2 live fidelity (BUG-05): these endpoints answer 401001
+            // 流程不存在！ for an ABSENT workflow rather than a null payload.
+            if (!wf)
+                return businessRefusal(401001, "流程不存在！");
+            return { code: wf.code, name: wf.name };
+        }
+        case "/api/api/workflow/get_draft": {
+            const wf = ctx.state.workflows.get(String(q.workflowCode ?? ""));
+            if (!wf)
+                return businessRefusal(401001, "流程不存在！");
+            return wf.template;
+        }
+        case "/api/api/workflow/get_published": {
+            const wf = ctx.state.workflows.get(String(q.workflowCode ?? ""));
+            // Live fidelity: like get_header/get_draft, an ABSENT workflow answers
+            // 401001 流程不存在！ rather than a null payload; the tool degrades that
+            // to exists:false. Ticket 77: an UNPUBLISHED workflow still answers the
+            // DRAFT shape here — data presence is not publish evidence. The
+            // published face carries the templateType PUBLISH marker.
+            if (!wf)
+                return businessRefusal(401001, "流程不存在！");
+            return wf.published ?? wf.template ?? null;
+        }
+        case "/api/api/workflow/update": {
+            const code = String(body.workflowCode ?? q.workflowCode ?? "");
+            const wf = ctx.state.workflows.get(code);
+            if (!wf)
+                return null;
+            // Ticket 112 platform fidelity (WorkflowTemplateUtil.java:90-171): an
+            // illegal templateType ("BusinessProcess" is not a
+            // WorkflowTemplateStatus member — valueOf at :136) or an activities
+            // element without a type makes the converter swallow the exception
+            // into a PARTIAL model; the save chain then fails with errcode 50000.
+            if (body.templateType === "BusinessProcess")
+                return businessRefusal(50000, "服务异常");
+            if (Array.isArray(body.activities) &&
+                body.activities.some((activity) => {
+                    const record = activity;
+                    const type = record != null && typeof record === "object" ? (record.type ?? record.activityType) : undefined;
+                    return type === undefined || type === null || String(type).trim() === "";
+                }))
+                return businessRefusal(50000, "服务异常");
+            if (body.activities !== undefined && invalidRenderShape(body))
+                return businessRefusal(50000, "服务异常");
+            // Platform fidelity (live 2026-09-23; bench12/13/15): an existing
+            // activityCode cannot be RENAMED or RETYPED — the stored name/type win.
+            // A caller that wants a different name/type must send it under a fresh
+            // code (the tool reconciles this before the wire); re-sending the same
+            // code with a changed name is a silent no-op on the platform, so the fake
+            // must reproduce it rather than store the body verbatim.
+            const stored = wf.template.activities;
+            const storedByCode = new Map((Array.isArray(stored) ? stored : []).map((activity) => [String(activity.activityCode ?? ""), activity]));
+            const pinned = Array.isArray(body.activities)
+                ? {
+                    ...body,
+                    activities: body.activities.map((activity) => {
+                        const prior = storedByCode.get(String(activity.activityCode ?? ""));
+                        return prior
+                            ? { ...activity, activityName: prior.activityName, i18nMessage: prior.i18nMessage, activityType: prior.activityType }
+                            : activity;
+                    }),
+                }
+                : body;
+            wf.template = { ...pinned };
+            return { code };
+        }
+        case "/api/api/workflow/validate":
+        case "/api/api/workflow/publish": {
+            const code = String(body.workflowCode ?? q.workflowCode ?? "");
+            const wf = ctx.state.workflows.get(code);
+            if (!wf)
+                return null;
+            if (body.activities !== undefined && invalidRenderShape(body))
+                return businessRefusal(50000, "服务异常");
+            // Live 8.6.26 fidelity (2026-09-17): validate/publish REFUSE with HTTP
+            // 200 + errcode 0 and the truth in `data` as ValidateMessage[]
+            // ({errCode, errContent, errorLevel}). The originate (first PARTICIPANT)
+            // node's participant must be the platform keyword "{Originator}" — a
+            // plain user/role value answers 401035 ERROR while errcode stays 0, and
+            // the flow never goes live. `{Creator}` on a non-originate node is a WARN
+            // (401062) that does not block.
+            const activities = Array.isArray(body.activities) ? body.activities : wf.template.activities;
+            const validation = validateWorkflowParticipants(activities);
+            if (input.path === "/api/api/workflow/validate")
+                return validation;
+            if (validation.some((message) => message.errorLevel === "ERROR"))
+                return validation;
+            // Ticket 77: the published face carries the PUBLISH marker (live readback
+            // evidence: publish state is identified by templateType:PUBLISH /
+            // version fields, never by data presence).
+            wf.published = { ...body, templateType: "PUBLISH", workflowVersion: (wf.published ? Number(wf.published.workflowVersion ?? 1) : 0) + 1 };
+            return { code, workflowVersion: wf.published.workflowVersion };
+        }
+        case "/api/api/workflow/delete":
+            ctx.state.workflows.delete(String(body.workflowCode ?? q.workflowCode ?? q.code ?? ""));
+            return null;
+        case "/api/api/runtime/workflow/search_workitems": {
+            // The real endpoint returns the caller's pending todos (biz_workitem only
+            // holds pending rows); finished items move to the finished store. The
+            // server's filterWorkflowInstanceId is a NOT-equal exclusion, so it is
+            // deliberately not honored here — exact instance matching is client-side.
+            let rows = [...ctx.state.workItems.values()].filter((item) => PENDING_STATES.has(item.state));
+            if (q.workflowCode)
+                rows = rows.filter((item) => item.workflowCode === q.workflowCode);
+            if (q.schemaCode)
+                rows = rows.filter((item) => item.schemaCode === q.schemaCode);
+            const page = Number(q.page ?? 0);
+            const size = Number(q.size ?? 20);
+            const start = page * size;
+            return {
+                totalElements: rows.length,
+                totalPages: size > 0 ? Math.ceil(rows.length / size) : 0,
+                content: rows.slice(start, start + size).map(toWorkItemVO),
+            };
+        }
+        case "/api/api/runtime/workflow/getBizObjectByWfInstanceId": {
+            const instanceId = String(q.workflowInstanceId ?? "");
+            const item = [...ctx.state.workItems.values()].find((candidate) => candidate.instanceId === instanceId);
+            if (!item)
+                return null;
+            return { id: item.bizObjectId, schemaCode: item.schemaCode };
+        }
+        case "/api/api/organization/role/list":
+            // Real shape: groups with `children` roles (see real-env observation).
+            return [
+                { id: "grp-1", name: "默认", code: "SYS_1000000", children: [{ id: "role-lead", name: "部门负责人", code: "SYS260630023816197", roleType: "SYS", corpId: "corp-1" }] },
+                { id: "role-finance", name: "财务负责人", code: "SYS260515031207258", roleType: "SYS", corpId: "corp-1" },
+            ];
+        case "/api/api/organization/department/tree":
+            return { departmentList: [{ id: "dept-1", name: "总所", code: "1", corpId: "corp-1", parentId: null }, { id: "dept-2", name: "业务部", code: "1_1", corpId: "corp-1", parentId: "dept-1" }] };
+        case "/api/api/organization/user/search": {
+            // UserController.search: @RequestBody {wd,page,size} → PageVO<UserVO>.
+            const wd = String(body.wd ?? "");
+            if (!wd)
+                return businessRefusal(10005, "关键字不能为空");
+            const users = [
+                { id: "user-1", username: "18900000001", name: "付文彬", departmentId: "dept-1", userId: "18900000001", status: "ENABLE", deleted: false, corpId: "corp-1" },
+                { id: "user-2", username: "18900000002", name: "李四", departmentId: "dept-2", userId: "18900000002", status: "ENABLE", deleted: false, corpId: "corp-1" },
+            ].filter((user) => user.name.includes(wd) || user.username.includes(wd));
+            const page = Number(body.page ?? 0);
+            const size = Number(body.size ?? 100);
+            return { totalElements: users.length, totalPages: size > 0 ? Math.ceil(users.length / size) : 0, content: users.slice(page * size, page * size + size) };
+        }
+        default:
+            return NOT_HANDLED;
+    }
+};
+//# sourceMappingURL=workflow.js.map

package/dist/field-change.js

@@ -1,5 +1,5 @@
 import { FIELD_PROPERTY_TYPES } from "./field-families.js";
-import { assertFormConditions, assertNumericalScale, assertFieldOptionsAllowed, buildChildTableSubSchema, buildFieldOptions, ensureRelationDisplayFieldOptions, normalizeFieldPropertyType, relationDisplayFieldCode, } from "./field-families.js";
+import { assertFormConditions, assertNumericalScale, assertFieldOptionsAllowed, buildChildTableSubSchema, buildFieldOptions, ensureRelationDisplayFieldOptions, normalizeFieldPropertyType, optionShapeFamily, relationDisplayFieldCode, withLegacyOptionSetKeys, } from "./field-families.js";
 import { nameI18nJson } from "./field-families.js";
 import { decodeJsonObjectColumn } from "./json-column.js";
 import { normalizeFormConditionOptions } from "./lanes/datarule-protocol.js";
@@ -50,6 +50,7 @@ export function prepareFieldChange(input) {
         propertyType: input.propertyType,
         ...(input.choices ? { choices: input.choices } : {}),
         ...(input.options ? { options: input.options } : {}),
+        ...(input.targetVersion ? { targetVersion: input.targetVersion } : {}),
     });
     assertRelationTargetPresent(propertyType, raw, input.relativeCode, input.code);
     // Gates run here so every entry point (direct, orchestrator, intent) shares them.
@@ -75,6 +76,62 @@ export function fieldChangeWireBody(input, prepared) {
         ...(input.relativeCode ? { relativeCode: input.relativeCode } : {}),
     };
 }
+/**
+ * 用新名称改写既有条目的 `name_i18n`，**保持原文形态**（字符串仍字符串、
+ * 对象仍对象、locale 键不变），只换承载名称的那一个键。8.1 的下拉原生是
+ * 字符串 `{"zh":...}`；8.2+ 用对象。形态跟原文走，避免跨版本写入把设计器
+ * 认不了的形态互相覆盖。
+ */
+function retitleI18n(existing, value) {
+    if (typeof existing === "string") {
+        try {
+            const parsed = JSON.parse(existing);
+            if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+                const record = parsed;
+                const key = Object.prototype.hasOwnProperty.call(record, "zh") ? "zh" : "zh-CN";
+                return JSON.stringify({ ...record, [key]: value });
+            }
+        }
+        catch {
+            /* 原文不是 JSON 对象串：按平台字符串形态重建 */
+        }
+        return JSON.stringify({ zh: value });
+    }
+    if (existing && typeof existing === "object" && !Array.isArray(existing)) {
+        const record = existing;
+        const key = Object.prototype.hasOwnProperty.call(record, "zh") ? "zh" : "zh-CN";
+        return { ...record, [key]: value };
+    }
+    return existing;
+}
+/**
+ * `choices` 更新选项族时的条目级合并：按 code 匹配既有条目，既有的未声明键
+ * （color / _key / published / metadata 等跨版本导入态）一律继承，新生成值
+ * 覆盖代码与取值；`name_i18n` 的形态跟既有条目走。未匹配的新条目保持生成形态。
+ */
+function mergeChoiceEntries(existing, next) {
+    if (!Array.isArray(next))
+        return next;
+    const previous = new Map();
+    if (Array.isArray(existing)) {
+        for (const entry of existing) {
+            if (entry && typeof entry === "object" && !Array.isArray(entry))
+                previous.set(String(entry.code ?? ""), entry);
+        }
+    }
+    return next.map((entry) => {
+        if (!entry || typeof entry !== "object" || Array.isArray(entry))
+            return entry;
+        const fresh = entry;
+        const old = previous.get(String(fresh.code ?? ""));
+        if (!old)
+            return fresh;
+        const merged = { ...old, ...fresh };
+        if (old.name_i18n !== undefined)
+            merged.name_i18n = retitleI18n(old.name_i18n, String(fresh.value ?? old.value ?? ""));
+        return merged;
+    });
+}
 export function prepareFieldUpdate(input) {
     // r26 快速装载：符号式/裸值条件就地编译为平台中文规范形状（合规式零改写）。
     const normalizedOptions = input.options === undefined ? undefined : normalizeFormConditionOptions(input.options);
@@ -99,12 +156,15 @@ export function prepareFieldUpdate(input) {
                 propertyType: recordType,
                 ...(input.choices ? { choices: input.choices } : {}),
                 ...(effectiveOptions ? { options: effectiveOptions } : {}),
+                ...(input.targetVersion ? { targetVersion: input.targetVersion } : {}),
             }),
         });
-    // 2026-10-29 防御（治豪 issue 的 optionsSet 覆盖风险）：带 choices 更新选项族时
-    // optionsSet 走保留式合并——以服务端原文 optionsSet 为基线，只换 custom 条目，
+    // 2026-10-29 治豪 issue：optionsSet 覆盖风险——以 choices 更新选项族时
+    // optionsSet 走保留式合并——以服务端原文 optionsSet 为基线，只换 custom 条目；
     // optionStructure/treeSelect/businessModel 等未声明键（含跨版本导入态）一律继承，
     // 不整体重建。锚定线（8.6/1.1.25）实测无此形状，纯防御。
+    // 2026-10-30 cpdocs issue #8：低版本（< 8.2）原文缺 optionStructure/treeSelect
+    // 时按族兜底补入，原文已有则不动；custom 条目按 code 级合并，保住 color/_key 等。
     const nextOptions = isChildTable
         ? currentOptions
         : input.choices !== undefined
@@ -112,10 +172,18 @@ export function prepareFieldUpdate(input) {
             && currentOptions.optionsSet !== undefined
             && currentOptions.optionsSet !== null
             && typeof currentOptions.optionsSet === "object"
-            ? {
-                ...rebuiltOptions,
-                optionsSet: { ...currentOptions.optionsSet, ...rebuiltOptions.optionsSet },
-            }
+            ? (() => {
+                const currentSet = currentOptions.optionsSet;
+                const rebuiltSet = rebuiltOptions.optionsSet;
+                return {
+                    ...rebuiltOptions,
+                    optionsSet: withLegacyOptionSetKeys({
+                        ...currentSet,
+                        ...rebuiltSet,
+                        custom: mergeChoiceEntries(currentSet.custom, rebuiltSet.custom),
+                    }, optionShapeFamily(input.targetVersion)),
+                };
+            })()
             : rebuiltOptions;
     if (!isChildTable && !effectiveOptions && !input.choices)
         Object.assign(nextOptions, currentOptions);

package/dist/field-families.js

@@ -553,8 +553,48 @@ export function normalizeMappingsOption(options) {
     const shapeChanged = Array.isArray(mappings) || (typeof mappings === "string" && mappings.trim() === "[]");
     return { options: next, ...(shapeChanged ? { note: `options.mappings 已归一为平台字符串形态：${normalized === "" ? "空串（无映射）" : String(normalized)}` } : {}) };
 }
+/**
+ * 8.2 以下的 optionsSet 额外带 `optionStructure` / `treeSelect`；8.2 及以上
+ * （实测 8.6.26 锚点、8.8 AI 生成包）不带。cp-model 侧实测（8.1.106/8.1.108）：
+ * 缺这两个键时设计器打开下拉字段的「自定义选项」弹窗，增删改任意操作点确定
+ * 都抛 `Cannot create property 'zh' on string ...`（cpdocs issue #8）。
+ * 只有确认是 8.0/8.1 才补——版本探测取不到或落在别的族（如门户版本号
+ * 1.1.x）时按未知处理，不猜。
+ */
+export const LEGACY_OPTION_SET_DEFAULTS = Object.freeze({
+    optionStructure: "flat",
+    treeSelect: Object.freeze({
+        fromLevel: 1,
+        limitLevelRangeEnabled: false,
+        storePathLabel: false,
+        enabled: false,
+        displayMode: "verticalTree",
+        selectableLevel: "leafOnly",
+    }),
+});
+export function optionShapeFamily(version) {
+    if (typeof version !== "string")
+        return undefined;
+    const match = /^\s*(\d+)\.(\d+)/u.exec(version);
+    if (!match)
+        return undefined;
+    const major = Number(match[1]);
+    const minor = Number(match[2]);
+    if (!Number.isInteger(major) || !Number.isInteger(minor))
+        return undefined;
+    if (major < 8)
+        return undefined;
+    return major === 8 && minor < 2 ? "legacy" : "modern";
+}
+/** legacy 族补齐 8.1 的 optionsSet 键；已有键不覆盖，modern/未知原样返回。 */
+export function withLegacyOptionSetKeys(optionsSet, family) {
+    if (family !== "legacy")
+        return optionsSet;
+    return { ...LEGACY_OPTION_SET_DEFAULTS, ...optionsSet };
+}
 export function buildFieldOptions(args) {
     const explicit = args.options;
+    const family = optionShapeFamily(args.targetVersion);
     const raw = args.propertyType;
     const type = typeof raw === "number" && Number.isInteger(raw)
         ? raw
@@ -586,18 +626,28 @@ export function buildFieldOptions(args) {
         // Ticket 108: no dictionaryData on selection rows — designer-produced
         // rows carry none (fwb §12-15) and the platform only accepts the extra
         // key, never requires it (live 8.6.26 write+read 2026-09-15).
+        // 8.1 原生条目形态（cpdocs issue #8 证据）：name_i18n 是字符串 `{"zh":...}`、
+        // 无 published、custom 场景 businessModel 为空对象。低版本按此生成，
+        // 8.2+ 维持锚点线（8.6）实测形态。
+        const custom = family === "legacy"
+            ? choices.map((value) => ({
+                code: value,
+                value,
+                name_i18n: JSON.stringify({ zh: value }),
+            }))
+            : choices.map((value) => ({
+                code: value,
+                value,
+                name_i18n: { "zh-CN": value, en: value },
+                published: false,
+            }));
         const selection = {
-            optionsSet: {
+            optionsSet: withLegacyOptionSetKeys({
                 optionsType: "custom",
-                custom: choices.map((value) => ({
-                    code: value,
-                    value,
-                    name_i18n: { "zh-CN": value, en: value },
-                    published: false,
-                })),
+                custom,
                 dictionary: {},
-                businessModel: { orderType: 1 },
-            },
+                businessModel: family === "legacy" ? {} : { orderType: 1 },
+            }, family),
         };
         return type !== undefined ? deriveFieldOptions(type, selection) : selection;
     }

package/dist/goal-routes.js

@@ -44,22 +44,22 @@ function intentGuidance() {
     return {
         path: "declarative",
         why: "整包需求：用一份声明式意图文件描述 models/fields/form/listview/rules/workflow/onlinejs/services，由编译器合成平台原生结构并按依赖顺序执行；比逐能力拼装更省上下文、更不易漂移。",
-        starter: `intentVersion: 1
-models:
-  - code: <模型code>          # 如 omcTodoTask（小写下划线也合规；字段码必须 lowerCamelCase ≤25 字符——产品实施规范）
-    name: <业务名>
-    fields:
-      - {code: title, name: 标题, type: SHORT_TEXT}
-      - {code: amount, name: 数量, type: NUMERICAL, options: {scale: 2}}   # NUMERICAL 必带 scale
-      - {code: level, name: 等级, type: RADIO, choices: [高, 中, 低]}        # 选择族用顶层 choices
-    form: {publish: true}
-    listview: {fieldCodes: [title, level]}
-    rules:
-      - code: Create            # 平台预置触发行（name 省略）
-        enabled: true
-        actions:
-          - when: [{field: amount, gt: 10}]
-            set: [{field: title, value: "超限"}]
+        starter: `intentVersion: 1
+models:
+  - code: <模型code>          # 如 omcTodoTask（小写下划线也合规；字段码必须 lowerCamelCase ≤25 字符——产品实施规范）
+    name: <业务名>
+    fields:
+      - {code: title, name: 标题, type: SHORT_TEXT}
+      - {code: amount, name: 数量, type: NUMERICAL, options: {scale: 2}}   # NUMERICAL 必带 scale
+      - {code: level, name: 等级, type: RADIO, choices: [高, 中, 低]}        # 选择族用顶层 choices
+    form: {publish: true}
+    listview: {fieldCodes: [title, level]}
+    rules:
+      - code: Create            # 平台预置触发行（name 省略）
+        enabled: true
+        actions:
+          - when: [{field: amount, gt: 10}]
+            set: [{field: title, value: "超限"}]
 `,
         commands: [
             "把上面的 starter 存成 <file>.yaml 按需求改字段后：omc intent validate <file>.yaml（离线）→ omc intent plan <file>.yaml --env <env> → omc intent apply <file>.yaml --env <env>（apply 也能直接吃 YAML）",