@stalfh233/omc-cli 0.4.35 → 0.4.37

package/dist/recipes/dictionary.js

@@ -0,0 +1,42 @@
+import { environment, commonRecovery } from "./shared.js";
+const dictionaryKeyValue = Object.freeze({
+    id: "dictionary-key-value",
+    title: "建一个键值字典并用其 id 作字段下拉来源",
+    status: "offline-valid",
+    tool: "dictionary.save",
+    args: {
+        environment,
+        code: "visitType",
+        name: "回访方式",
+        dictionaryType: 0,
+        records: [
+            { code: "phone", name: "电话" },
+            { code: "visit", name: "上门" },
+            { code: "online", name: "线上" },
+        ],
+    },
+    preconditions: ["字典 code 尚未存在（存在须改传 id 更新）；dictionaryType 0=KEY_VALUE / 1=TREE"],
+    conditionalRequirements: [
+        "**字段下拉绑定字典时 `checkedDictionary` 必须填字典 id（不是 name）**——前端 a-select 的 option value 就是 id；填 name 运行时会返回『字典已被禁用，无数据』、下拉空白（真机 ticket 02/34）。拿到 id：`dictionary.get`/`dictionary.names` 读回。",
+        "TREE 字典的 record 可带 `parentId`；给既有字典加记录也走 `dictionary.save`（带 id + 完整 records）。",
+        "字段侧用 `field.create` 的 `options.optionsSet = {optionsType:'dictionary',dictionary:{checkedDictionary:'<id>',checkedDictionaryCode:'<code>',useDictionariesData:[{code,name,id}]}}`；`choices` 是「手写选项」的另一条路，不要与字典混用。",
+    ],
+    priorToolReferences: [
+        { tool: "dictionary.names", args: { environment }, purpose: "查 code/name 冲突并读回既有 id（字典多时结果会溢成 artifact；只需 code/name，用 `artifact get <id> --keys` 或 --jq，别整份取）" },
+        { tool: "dictionary.get", args: { environment, code: "visitType" }, purpose: "按 code 精确查存在性（小结果，优于 dictionary.names 全量）" },
+    ],
+    dryRun: { supported: true, command: `omc call dictionary.save --env ${environment} --dry-run --args '<recipe.args>'`, notes: "dry-run 预检 code 冲突/形状，不写" },
+    expectedReadback: { performed: { errcode: 0 }, readback: { present: true, dictionary: { id: "<dictionary.id>", code: "visitType", records: ["phone", "visit", "online"] } }, next: ["field.create --example dictionary-backed-single-select（用回读的 id）"] },
+    refusalRecovery: [
+        { code: "dictionary-create-duplicate", action: "code 已存在：从 dictionary.names 取 id 后改传 id 做更新" },
+        { code: "wire-business", action: "平台 `errcode -1 系统中已经存在相同名称的字典` = **字典名称全局唯一**（code 唯一还不够）——换一个 name（真机 2026-09-25：新 code + 旧 name 仍被拒）" },
+        { code: "capability-out-of-coverage", action: "确认 dictionaryType 0/1 与 records[{code,name}] 形状" },
+        ...commonRecovery,
+    ],
+    requiresEnvironmentDerivedIds: true,
+    prerequisiteData: { source: "dictionary.get / dictionary.names", fields: ["dictionary.id"] },
+});
+export const DICTIONARY_METADATA = Object.freeze({
+    "dictionary.save": Object.freeze({ recipes: [dictionaryKeyValue], relatedTools: ["dictionary.names", "dictionary.records", "field.create"] }),
+});
+//# sourceMappingURL=dictionary.js.map

package/dist/recipes/field.js

@@ -0,0 +1,230 @@
+import { environment, model, commonRecovery } from "./shared.js";
+const fieldSerialNumber = Object.freeze({
+    id: "field-serial-number",
+    title: "单据号字段：表单 Serial Number 控件（seqNoSetting 分段构建器，按天/月/年重置原生）——不要落 SequenceService SPI 二开",
+    status: "offline-valid",
+    tool: "field.update",
+    args: {
+        environment,
+        schemaCode: "crm_contract",
+        code: "<字段 code>",
+        name: "合同编号",
+        options: {
+            formPropertyType: 100,
+            seqNoSetting: [
+                { type: "CONSTANT", value: "CT-" },
+                { type: "DATE", value: "yyyyMMdd" },
+                { type: "CONSTANT", value: "-" },
+                { type: "SEQNO", value: { startValue: 1, maxLength: 4, leftPad: true, resetDate: "DAY" } },
+            ],
+        },
+    },
+    preconditions: [
+        "需求是**编号自动生成**（前缀/日期/流水/按期重置），不是人工填写的编号字段——人工填写用普通短文本，别用本配方。",
+        "**单据号=表单 Serial Number 控件（字段类型 100 SequenceNo）**，不是 SHORT_TEXT 字段 + SequenceService SPI 二开（r5-crm 实证：SPI 路线在 8.6.26 无触发配置可写、属重造轮子；表单控件开箱即用）。",
+    ],
+    conditionalRequirements: [
+        "seqNoSetting 是**段数组**（分段构建器，顺序即拼接序）：CONSTANT（固定前缀/分隔）/ DATE（value=Java 格式串 yyyyMMdd 等）/ SEQNO（流水）/ DATAITEM（取行内字段值）/ UID。设计师入口=控件属性「Document Number Configuration」。",
+        "SEQNO 段：startValue（起始）、maxLength（位数）、leftPad（补零）、**resetDate（重置策略 NONE/DAY/MONTH/YEAR——按天重置是原生能力）**。",
+        "写完必须 `field.publish` + `configure_form`（rebuild:true）重建表单并发布，控件才落到表单 attributes 的 options.seqNoSetting。",
+        "**编号生成时机=submit（表单提交管线）**：`data.save`（含 submit:true）不生成编号、行落 DRAFT；直接 `data.submit`（不带 bizObjectId=新建并提交）生成编号且行 COMPLETED（r5-crm 真机：CT-20261009-0001→0002 双跑）。",
+        "验证：连续两次 data.submit，编号应 +1 且格式符合段拼接；跨天重置由 resetDate 保证（勿自建 Redis 计数）。",
+    ],
+    priorToolReferences: [{ tool: "field.get", args: { environment, schemaCode: "<模型>", code: "<字段 code>" }, purpose: "确认字段存在且未配置过 seqNoSetting" }],
+    dryRun: { supported: true, command: `omc call field.update --env ${environment} --dry-run --args '<recipe.args>'`, notes: "dry-run 校验 options 形状，零 wire" },
+    expectedReadback: { performed: { errcode: 0 }, readback: { fieldPresent: true, optionsContain: "seqNoSetting+formPropertyType:100" }, next: ["data.submit 双跑 → 编号 0001/0002、行 COMPLETED"] },
+    refusalRecovery: [
+        { code: "field-options-freeform", action: "options 是自由对象——形状错误不会被出门校验拦，务必对照本配方逐键核对（type 全大写、resetDate 大写枚举）" },
+        ...commonRecovery,
+    ],
+    requiresEnvironmentDerivedIds: false,
+});
+const formConditionalRequired = Object.freeze({
+    id: "form-conditional-required",
+    title: "表单层条件必填：金额大于阈值时说明必填（字段 options）",
+    status: "requires-prior-readback",
+    tool: "field.update",
+    args: {
+        environment,
+        schemaCode: model,
+        code: "leaveReason",
+        name: "请假事由",
+        options: { requiredFormula: '{leave_amount} 大于 {"valueType":"custom","value":5000}' },
+    },
+    preconditions: ["目标字段与作为条件的字段都已发布", "这是门户表单交互层（真实门户打开表单、改条件字段值来验证控件是否变必填）；**不要用 datarule.create**——实测 type4 不会让门户控件变必填，且符号式经 historyOpt 会让表单渲染崩溃"],
+    conditionalRequirements: ["条件串：`{字段} 操作符 [值]`（操作符两侧留空格）。操作符用**中文**（真实设计器产出）：等于/不等于/大于/小于/大于等于/小于等于/包含/不包含/包含全部/包含任意一个/等于任意一个/为空/不为空；也接受符号 == != > >= <= Contains IsEmpty。为空/不为空**不带值**（`{reason} 不为空`），其余带 JSON 值 {\"valueType\":...,\"value\":...}。多条件用 ` && `、多组用 ` || `。**不是** eq/gt/isnull——会让门户渲染 SyntaxError"],
+    priorToolReferences: [{ tool: "field.list", args: { environment, schemaCode: model, published: true }, purpose: "确认条件字段与目标字段都已发布" }],
+    dryRun: { supported: true, command: `omc call field.update --env ${environment} --dry-run --args '<recipe.args>'`, notes: "dry-run 校验字段 options 形状，不写入" },
+    expectedReadback: { readback: { field: { code: "leaveReason", options: { requiredFormula: "<protocol>" } } }, next: ["（一调）field.update cascadeRepublish:true", "（分步）field.publish → form.draft(rebuild) → form.publish", "（只刷新表单）form.publish rebuild:true"] },
+    refusalRecovery: [
+        { code: "capability-out-of-coverage", action: "条件串用中文或符号操作符（等于/大于/不为空 或 == />/IsEmpty）；恒必填用字面量 \"true\"" },
+        ...commonRecovery,
+    ],
+    requiresEnvironmentDerivedIds: false,
+});
+const formAlwaysReadonly = Object.freeze({
+    id: "form-always-readonly",
+    title: "表单层恒只读字段（字段 options.readonlyFormula:true）",
+    status: "offline-valid",
+    tool: "field.update",
+    args: { environment, schemaCode: model, code: "approvalLevel", name: "审批级别", options: { readonlyFormula: true } },
+    preconditions: ["目标字段已发布"],
+    conditionalRequirements: ["恒只读用布尔 readonlyFormula:true；条件只读用 readonlyCondition 条件串"],
+    priorToolReferences: [{ tool: "field.list", args: { environment, schemaCode: model, published: true }, purpose: "确认字段已发布" }],
+    dryRun: { supported: true, command: `omc call field.update --env ${environment} --dry-run --args '<recipe.args>'`, notes: "dry-run 校验 readonlyFormula 是布尔", },
+    expectedReadback: { readback: { field: { code: "approvalLevel", options: { readonlyFormula: true } } }, next: ["（一调）field.update cascadeRepublish:true", "（分步）field.publish → form.draft(rebuild) → form.publish", "（只刷新表单）form.publish rebuild:true"] },
+    refusalRecovery: [{ code: "capability-out-of-coverage", action: "readonlyFormula 必须是布尔 true；条件只读才用 readonlyCondition" }, ...commonRecovery],
+    requiresEnvironmentDerivedIds: false,
+});
+const formConditionalReadonly = Object.freeze({
+    id: "form-conditional-readonly",
+    title: "表单层条件只读（字段 options.readonlyCondition）",
+    status: "offline-valid",
+    tool: "field.update",
+    args: {
+        environment,
+        schemaCode: model,
+        code: "approvalLevel",
+        name: "审批级别",
+        options: { readonlyCondition: '{status} 等于 {"valueType":"specifyOption","value":"已通过"}' },
+    },
+    preconditions: ["目标字段与条件字段已发布"],
+    conditionalRequirements: ["条件串协议同必填；恒只读改用 readonlyFormula:true"],
+    priorToolReferences: [{ tool: "field.list", args: { environment, schemaCode: model, published: true }, purpose: "确认字段已发布" }],
+    dryRun: { supported: true, command: `omc call field.update --env ${environment} --dry-run --args '<recipe.args>'`, notes: "dry-run 校验条件串协议" },
+    expectedReadback: { readback: { field: { code: "approvalLevel", options: { readonlyCondition: "<protocol>" } } }, next: ["（一调）field.update cascadeRepublish:true", "（分步）field.publish → form.draft(rebuild) → form.publish", "（只刷新表单）form.publish rebuild:true"] },
+    refusalRecovery: [{ code: "capability-out-of-coverage", action: "使用中文或符号操作符与三段条件串" }, ...commonRecovery],
+    requiresEnvironmentDerivedIds: false,
+});
+const numericTwoDecimals = Object.freeze({
+    id: "numeric-two-decimals",
+    title: "数值字段（金额，两位小数 / 整数）— scale 必填",
+    status: "offline-valid",
+    tool: "field.create",
+    args: { environment, schemaCode: model, code: "applyAmount", name: "申请金额", propertyType: "NUMERICAL", options: { scale: 3 } },
+    preconditions: ["模型已存在"],
+    conditionalRequirements: ["NUMERICAL 必须显式 options.scale：scale = 小数位数（0=整数, 1=1位, 2=2位 … 8=8位）；缺 scale 门户显示裸 decimal 且工具会拒绝。"],
+    priorToolReferences: [{ tool: "discover_environment", args: { environment }, purpose: "确认目标模型已存在" }],
+    dryRun: { supported: true, command: `omc call field.create --env ${environment} --dry-run --args '<recipe.args>'`, notes: "dry-run 校验 propertyType/scale/治理，不创建" },
+    expectedReadback: { readback: { draftFieldPresent: true }, next: ["field.publish"] },
+    refusalRecovery: [{ code: "capability-out-of-coverage", action: "NUMERICAL 必须带 options.scale；金额两位小数用 scale:2，整数用 scale:0" }, ...commonRecovery],
+    requiresEnvironmentDerivedIds: false,
+});
+const dictionarySelection = Object.freeze({
+    id: "dictionary-backed-single-select",
+    title: "先读字典，再创建字典-backed 单选字段",
+    status: "requires-prior-readback",
+    tool: "field.create",
+    args: {
+        environment,
+        schemaCode: model,
+        code: "status",
+        name: "状态",
+        propertyType: "DROPDOWN_BOX",
+        options: {
+            optionsSet: {
+                optionsType: "dictionary",
+                dictionary: {
+                    checkedDictionary: "<dictionary.id>",
+                    checkedDictionaryCode: "<dictionary.code>",
+                    useDictionariesData: [{ code: "<record.code>", name: "<record.name>", id: "<record.id>" }],
+                },
+            },
+        },
+    },
+    preconditions: ["目标模型已存在；字段 code 尚未存在；字典及其至少一个启用记录可由只读发现取得"],
+    conditionalRequirements: ["若字典树有 parentId，dictionary.records 必须带 parentId；否则用 dictionary.records 的 id 或 code"],
+    priorToolReferences: [
+        { tool: "dictionary.names", args: { environment }, purpose: "选择环境中的 dictionary id/name/code；checkedDictionary 必须填 **id**（前端 a-select 的 option value 就是 a.id；填 name 运行时 getEnableRecordsByDictionaryId 会返回『字典已被禁用，无数据』，下拉空白）" },
+        { tool: "dictionary.records", args: { environment, code: "<dictionary.code>", enabledOnly: true }, purpose: "取得 useDictionariesData；替换 recipe 中的环境 ID" },
+    ],
+    dryRun: { supported: true, command: `omc call field.create --env ${environment} --dry-run --args '<recipe.args>'`, notes: "dry-run 只做 schema/语义/治理预检，不创建字段" },
+    expectedReadback: { performed: { dryRun: true }, readback: { draftFieldPresent: false, next: "field.publish" } },
+    refusalRecovery: [
+        { code: "field-family-options-invalid", action: "确保 options.optionsSet.dictionary 的 checkedDictionary、checkedDictionaryCode 和 useDictionariesData 来自同一字典" },
+        { code: "duplicate-field", action: "先 field.list 读取草稿/发布面；已有字段改用 field.update" },
+        ...commonRecovery,
+    ],
+    requiresEnvironmentDerivedIds: true,
+    prerequisiteData: { source: "dictionary.names → dictionary.records(enabledOnly:true)", fields: ["dictionary.code", "record.code", "record.id"] },
+});
+const childTable = Object.freeze({
+    id: "minimal-child-table",
+    title: "创建带两个标量列的子表字段",
+    status: "offline-valid",
+    tool: "field.create",
+    args: {
+        environment,
+        schemaCode: model,
+        code: "<model>_items",
+        name: "明细",
+        propertyType: "CHILD_TABLE",
+        subFields: [
+            { code: "itemName", name: "名称", propertyType: "SHORT_TEXT" },
+            { code: "itemQty", name: "数量", propertyType: "NUMERICAL", options: { scale: 1 } },
+        ],
+    },
+    preconditions: ["目标模型已存在；父字段 code 和子列 codes 尚未存在；父模型字段发布后再配置表单"],
+    conditionalRequirements: [
+        "**子表 `code` 会成为全局子 schema code——必须模型作用域唯一（如 `<model>_items`），不要用通用名如 `items`/`purchase_items`，否则撞名时平台只回 errcode 40000「调用数据库发生异常」（实测）**；",
+        "子表列不得是 CHILD_TABLE、OCR、ELECTRONIC_SIGN、RELEVANCE_DATA 或 FORMULA；关系列必须另带 relativeCode 与 options；子列 NUMERICAL 同样必须带 options.scale",
+    ],
+    priorToolReferences: [],
+    dryRun: { supported: true, command: `omc call field.create --env ${environment} --dry-run --args '<recipe.args>'`, notes: "dry-run 验证 subFields 并跳过环境写入" },
+    expectedReadback: { readback: { field: { code: "items", propertyType: "CHILD_TABLE", subSchema: { properties: ["itemName", "itemQty"] } } }, next: ["field.publish", "form.draft", "form.publish"] },
+    refusalRecovery: [
+        { code: "capability-out-of-coverage", action: "补齐 subFields，并移除不支持的嵌套/高级子列族" },
+        { code: "child-table-update-unsupported", action: "子列用 schemaCode=items 的 field.create/update；不要向父字段 update 传 options/choices/subFields" },
+        ...commonRecovery,
+    ],
+    requiresEnvironmentDerivedIds: false,
+});
+const businessModelDropdown = Object.freeze({
+    id: "business-model-dropdown",
+    title: "用另一个模型的数据作下拉来源（businessModel）",
+    status: "requires-prior-readback",
+    tool: "field.create",
+    args: {
+        environment,
+        schemaCode: model,
+        code: "category",
+        name: "类别",
+        propertyType: "DROPDOWN_BOX",
+        options: {
+            optionsSet: {
+                optionsType: "businessModel",
+                businessModel: {
+                    schemaCode: "<source.model>",
+                    sheetDataItem: "<source.businessField>",
+                    appCode: "<app.code>",
+                },
+            },
+        },
+    },
+    preconditions: [
+        "目标模型与来源模型都已存在",
+        "来源模型的显示字段已 field.publish 并已 form.publish（未发布字段不可作为下拉来源）",
+    ],
+    conditionalRequirements: [
+        "sheetDataItem 指向来源模型上真正承载业务值的字段；**不要用系统字段 name** —— 它是平台自动生成的数据标题（人名+模型名+时间），下拉项会显示这串标题而不是业务值",
+        "orderByFields/orderType 可选，用于下拉项排序；conditions 可选，用于过滤来源行",
+    ],
+    priorToolReferences: [
+        { tool: "discover_environment", args: { environment, full: true }, purpose: "取得来源模型 schemaCode 与 app.code" },
+        { tool: "field.list", args: { environment, schemaCode: "<source.model>", published: true, fields: ["<source.businessField>"] }, purpose: "确认显示字段已发布并取其 code" },
+    ],
+    dryRun: { supported: true, command: `omc call field.create --env ${environment} --dry-run --args '<recipe.args>'`, notes: "dry-run 校验 optionsSet.businessModel 的形状，不创建字段" },
+    expectedReadback: { readback: { field: { code: "category", propertyType: "DROPDOWN_BOX", options: { optionsSet: { optionsType: "businessModel" } } } }, next: ["field.publish", "form.draft", "form.publish"] },
+    refusalRecovery: [
+        { code: "field-family-options-invalid", action: "确保 optionsSet.businessModel 带 schemaCode 与 sheetDataItem，且 schemaCode 是已存在的模型" },
+        { code: "duplicate-field", action: "先 field.list 读取草稿/发布面；已有字段改用 field.update" },
+        ...commonRecovery,
+    ],
+    requiresEnvironmentDerivedIds: true,
+    prerequisiteData: { source: "discover_environment → field.list(published:true)", fields: ["source.model", "source.businessField", "app.code"] },
+});
+export const FIELD_METADATA = Object.freeze({
+    "field.update": Object.freeze({ recipes: [fieldSerialNumber, formConditionalRequired, formAlwaysReadonly, formConditionalReadonly], relatedTools: ["field.list", "field.publish", "form.draft", "form.publish"] }),
+    "field.create": Object.freeze({ recipes: [numericTwoDecimals, dictionarySelection, childTable, businessModelDropdown], relatedTools: ["dictionary.names", "dictionary.records", "discover_environment", "field.list", "field.publish", "form.draft", "configure_form", "form.publish"] }),
+});
+//# sourceMappingURL=field.js.map

package/dist/recipes/form.js

@@ -0,0 +1,19 @@
+import { environment, model, commonRecovery } from "./shared.js";
+const configureFormRecipe = Object.freeze({
+    id: "publish-default-form",
+    title: "把已发布字段绑进默认表单并发布（高层编排）",
+    status: "offline-valid",
+    tool: "configure_form",
+    args: { environment, schemaCode: model, publish: true },
+    preconditions: ["字段已 field.publish"],
+    conditionalRequirements: ["表单层条件必填/只读请用 field.update 的 options（form-conditional-required / form-always-readonly recipe），不是本编排器"],
+    priorToolReferences: [{ tool: "field.list", args: { environment, schemaCode: model, published: true }, purpose: "确认字段已发布" }],
+    dryRun: { supported: true, command: `omc call configure_form --env ${environment} --dry-run --args '<recipe.args>'`, notes: "dry-run 预检，不写" },
+    expectedReadback: { readback: { formPublished: true }, next: ["listview.configure（默认视图已存在，勿 listview.create）", "field.update（表单层条件）"] },
+    refusalRecovery: [{ code: "capability-out-of-coverage", action: "先发布字段再发表单" }, ...commonRecovery],
+    requiresEnvironmentDerivedIds: false,
+});
+export const FORM_METADATA = Object.freeze({
+    "configure_form": Object.freeze({ recipes: [configureFormRecipe], relatedTools: ["field.list", "field.update", "listview.create", "listview.get"] }),
+});
+//# sourceMappingURL=form.js.map

package/dist/recipes/list-view.js

@@ -0,0 +1,31 @@
+import { environment, model, commonRecovery } from "./shared.js";
+const listViewConfigure = Object.freeze({
+    id: "configure-default-list",
+    title: "配置模型的默认列表视图（列/排序；默认视图已自动存在）",
+    status: "requires-prior-readback",
+    tool: "listview.configure",
+    args: { environment, schemaCode: model, fieldCodes: ["applyNo", "applyAmount", "applyNote"] },
+    preconditions: ["字段已 field.publish（视图与表单脚手架都依赖已发布字段）", "默认视图在 model.create 时由平台自动生成，code = schemaCode"],
+    conditionalRequirements: [
+        "**省略 `code` 即配置默认视图（code = schemaCode）；不要先 listview.create——那会多出一个自定义视图。** 只有确实需要第二个视图时才 listview.create。",
+        "`fieldCodes` 只列业务字段，可给 propertyCode 或字段显示名；系统列由平台决定。未知引用被拒（listview-columns-unknown-field）。",
+        "数值列 displayFormat 由字段 0 基 `options.scale` 推导（0=整数,1=1位,2=2位…）；本工具会原地修正既有列的 displayFormat。",
+        "`query/update` 自动 publish=TRUE——视图无草稿/发布两态，无需独立发布步骤。",
+    ],
+    priorToolReferences: [
+        { tool: "listview.list", args: { environment, schemaCode: model }, purpose: "确认默认视图 code 与是否已有多视图" },
+        { tool: "field.list", args: { environment, schemaCode: model, published: true }, purpose: "确认字段已发布" },
+    ],
+    dryRun: { supported: true, command: `omc call listview.configure --env ${environment} --dry-run --args '<recipe.args>'`, notes: "dry-run 预检 fieldCodes/形状，不写" },
+    expectedReadback: { readback: { code: "<schemaCode>", added: ["applyNo", "applyAmount"], columns: "…" }, next: ["data.list 验证读面"] },
+    refusalRecovery: [
+        { code: "listview-columns-unknown-field", action: "字段未发布或名字写错；先 field.create + field.publish 或改引用" },
+        { code: "listview-not-found", action: "默认视图应已存在；用 listview.list 确认 code，必要时 listview.create" },
+        ...commonRecovery,
+    ],
+    requiresEnvironmentDerivedIds: false,
+});
+export const LISTVIEW_METADATA = Object.freeze({
+    "listview.configure": Object.freeze({ recipes: [listViewConfigure], relatedTools: ["listview.list", "listview.get", "field.list", "field.publish"] }),
+});
+//# sourceMappingURL=list-view.js.map

package/dist/recipes/model.js

@@ -0,0 +1,34 @@
+import { environment, commonRecovery } from "./shared.js";
+const configureModelRecipe = Object.freeze({
+    id: "model-with-fields-form",
+    title: "一次建模型 + 多字段 + 发布默认表单（高层编排）",
+    status: "offline-valid",
+    tool: "configure_model",
+    args: {
+        environment,
+        name: "采购申请",
+        code: "purchaseApply",
+        applicationCode: "<applicationCode>",
+        fields: [
+            { code: "applyNo", name: "申请编号", propertyType: "SHORT_TEXT" },
+            { code: "applyAmount", name: "申请金额", propertyType: "NUMERICAL", options: { scale: 2 } },
+            { code: "applyNote", name: "申请说明", propertyType: "LONG_TEXT" },
+        ],
+        publishForm: true,
+    },
+    preconditions: ["应用 code 已确认（discover_environment）"],
+    conditionalRequirements: [
+        "fields[].propertyType 用族名；NUMERICAL 必须 options.scale（scale = 小数位数：金额两位小数用 scale:2，整数用 scale:0）",
+        "子表/单选/人员等复杂族建议改用低层 field.create（configure_model 的 fields[] 只覆盖标量族最稳）",
+    ],
+    priorToolReferences: [{ tool: "discover_environment", args: { environment }, purpose: "取 applicationCode 与已有模型" }],
+    dryRun: { supported: true, command: `omc call configure_model --env ${environment} --dry-run --args '<recipe.args>'`, notes: "dry-run 走 schema/语义/治理预检，不创建" },
+    expectedReadback: { readback: { modelPresent: true, publishedFields: ["applyNo", "applyAmount", "applyNote"] }, next: ["field.update（表单层条件）", "listview.configure（默认视图已自动存在，直接配置，勿 create）"] },
+    refusalRecovery: [{ code: "capability-out-of-coverage", action: "标量族之外改用低层 field.create；NUMERICAL 补 options.scale" }, ...commonRecovery],
+    requiresEnvironmentDerivedIds: true,
+    prerequisiteData: { source: "discover_environment", fields: ["applicationCode"] },
+});
+export const MODEL_METADATA = Object.freeze({
+    "configure_model": Object.freeze({ recipes: [configureModelRecipe], relatedTools: ["discover_environment", "field.update", "listview.create", "listview.get"] }),
+});
+//# sourceMappingURL=model.js.map

package/dist/recipes/online-js.js

@@ -0,0 +1,32 @@
+import { environment, model } from "./shared.js";
+const onlinejsHighlightScript = Object.freeze({
+    id: "field-value-driven-style",
+    title: "按字段值驱动另一控件样式（生命周期外壳 + valueChange 订阅）",
+    status: "offline-valid",
+    tool: "onlinejs.compose",
+    args: {
+        environment,
+        schemaCode: model,
+        sheetCode: "<默认表单 code == 模型 code>",
+        mode: "replace",
+        source: "(function(form){ var amt = form.getControl('amountCode'); var party = form.getControl('targetCode'); function refresh(v){ party.options.style = Number(v) > 100000 ? 'color: red;' : ''; } form.on('onRendered', function(){ refresh(amt.getValue()); amt.valueChange.subscribe(function(change){ refresh(change.value); }); }); })",
+    },
+    preconditions: [
+        "控件编码先 model.inspect/field.list 确认（示例 amountCode/targetCode 换成真实字段 code）",
+        "完整 `(function(form){…})` 生命周期外壳必须 mode:'replace'（merge 模式收外壳会被拒并指路 replace——r38 实证）",
+    ],
+    conditionalRequirements: [
+        "事件模型：`form.on('onRendered', …)` 初始化 + `<控件>.valueChange.subscribe(function(change){ change.value })` 监听；改样式用 `control.options.style`",
+        "**脚本含引号/较长时不要塞 --args 内联**——写 JSON 参数文件走 `--args-file <path>`（shell 引号拆参 r38 实证）",
+        "深入教学面：`.claude/skills/form-online-js/references/`（lifecycle-api/control-api）",
+    ],
+    priorToolReferences: [{ tool: "form.get", args: { environment, schemaCode: model }, purpose: "确认表单已发布与控件编码" }],
+    dryRun: { supported: true, command: `omc call onlinejs.compose --env ${environment} --dry-run --args-file compose.json`, notes: "dry-run 校验外壳/合并模式，不写平台" },
+    expectedReadback: { readback: { deliveryState: "DELIVERED", published: true, scriptElementPresent: true, htmlRenderCompat: { draft: { ok: true }, published: { ok: true } } } },
+    refusalRecovery: [{ code: "merge-mode-requires-shell", action: "完整外壳改 mode:'replace'（六元素模板保留，仅整体替换 customScript）" }],
+    requiresEnvironmentDerivedIds: false,
+});
+export const ONLINEJS_METADATA = Object.freeze({
+    "onlinejs.compose": Object.freeze({ recipes: [onlinejsHighlightScript], relatedTools: ["form.get", "form.draft", "form.publish"] }),
+});
+//# sourceMappingURL=online-js.js.map

package/dist/recipes/runtime-data.js

@@ -0,0 +1,113 @@
+import { environment, model, commonRecovery } from "./shared.js";
+const workflowSave = Object.freeze({
+    id: "workflow-backed-data-save",
+    title: "用 data.save 创建 DRAFT workflow row",
+    status: "requires-prior-readback",
+    tool: "data.save",
+    args: { environment, schemaCode: model, workflowCode: "<workflow.code>", formData: { name: "recipe draft" } },
+    preconditions: ["模型默认表单/字段和 workflow 已发布；应用可用；formData 不带已存在 id"],
+    conditionalRequirements: ["workflow draft-save 总是 INSERT；不要把已存在记录 id 放进 formData"],
+    priorToolReferences: [
+        { tool: "workflow.get_published", args: { environment, workflowCode: "<workflow.code>" }, purpose: "确认 published-face marker" },
+    ],
+    dryRun: { supported: true, command: `omc call data.save --env ${environment} --dry-run --args '<recipe.args>'`, notes: "save dry-run 只校验输入与治理；真实两段式身份只能由执行后的 readback 提供" },
+    expectedReadback: { performed: { formType: "save-draft-workflow", captures: ["bizObjectId", "workflowInstanceId", "workItemId"] }, readback: { sequenceStatus: "DRAFT", next: "data.submit" } },
+    refusalRecovery: [
+        { code: "save-workflow-draft-with-id-unsupported", action: "移除已存在 id；workflow draft-save 只支持 INSERT" },
+        { code: "app-not-published", action: "只读确认应用发布状态后修复发布边界；不要盲目重试 runtime 写入" },
+        ...commonRecovery,
+    ],
+    requiresEnvironmentDerivedIds: true,
+    prerequisiteData: { source: "workflow.get_published; data.save authoritative readback", fields: ["workflow.code", "bizObjectId", "workflowInstanceId", "workItemId"] },
+});
+const plainSubmit = Object.freeze({
+    id: "plain-data-submit",
+    title: "无流程模型：新建并提交一调完成（COMPLETED，触发 Create 规则）——正式数据的标准路径",
+    status: "offline-valid",
+    tool: "data.submit",
+    args: { environment, schemaCode: model, formData: { name: "正式记录" } },
+    preconditions: ["模型无已发布流程（有流程走 workflow-backed-data-submit）", "模型+表单已发布"],
+    conditionalRequirements: [
+        "**不带 bizObjectId 即新建并提交**（工具内部建稿+直提，一次调用 COMPLETED）；已有草稿要直提时才带 data.save 读回的 bizObjectId；不要手造 id",
+        "**目标模型已发布流程时行为不同（r36 实证）**：无 workItemId 的 data.submit = 一调新建并**启动流程**（PROCESSING，读回返回首审批待办 workItemId）——合法路径非错误；要『先草稿后提交/中途改稿』用两段式 data.save（草稿读回三元身份）→ data.submit(workItemId)",
+    ],
+    priorToolReferences: [],
+    dryRun: { supported: true, command: `omc call data.submit --env ${environment} --dry-run --args '<recipe.args>'`, notes: "dry-run 验证参数关系，不推进状态" },
+    expectedReadback: { performed: { errcode: 0 }, readback: { sequenceStatus: "COMPLETED" } },
+    refusalRecovery: [
+        { code: "submit-biz-object-absent", action: "bizObjectId 在平台无行（304001）——回 data.save 重建草稿后再直提" },
+        { code: "invalid-input", action: "带了 workItemId/workflowInstanceId 时必须同时带 bizObjectId（fail-closed）" },
+    ],
+    notes: "r23 复盘修正：本配方曾教先 save 再 submit 两步——正确路径是无 id 一调（业务约定：正式数据一律 data.submit）。Create/Update 规则只在 COMPLETED 分发（DomainServiceImpl.java:240-248）；规则效果以提交读回/data.load 为准。data.save 定位=草稿/暂存",
+    requiresEnvironmentDerivedIds: true,
+});
+const workflowSubmit = Object.freeze({
+    id: "workflow-backed-data-submit",
+    title: "消费 data.save 读回身份并提交 workflow work item",
+    status: "requires-prior-readback",
+    tool: "data.submit",
+    args: { environment, schemaCode: model, workflowCode: "<workflow.code>", bizObjectId: "<data.save.performed.bizObjectId>", workflowInstanceId: "<data.save.performed.workflowInstanceId>", workItemId: "<data.save.performed.workItemId>", formData: { name: "recipe draft" } },
+    preconditions: ["同一 recipe 的 data.save 已成功并读回 DRAFT；workflowInstanceId/workItemId/bizObjectId 均非空"],
+    conditionalRequirements: ["workItemId 或 workflowInstanceId 出现时必须传 bizObjectId；身份只能复制 data.save 的 authoritative readback"],
+    priorToolReferences: [
+        { tool: "data.save", args: { environment, schemaCode: model, workflowCode: "<workflow.code>", formData: { name: "recipe draft" } }, purpose: "提供三个环境生成的提交身份" },
+        { tool: "workitem.list", args: { environment }, purpose: "当 data.save 未直接返回 workItemId 时按 workflowInstanceId 解析待办" },
+    ],
+    dryRun: { supported: true, command: `omc call data.submit --env ${environment} --dry-run --args '<recipe.args>'`, notes: "dry-run 验证两段式参数关系，不推进 workflow" },
+    expectedReadback: { performed: { formType: "1" }, readback: { sequenceStatus: "COMPLETED", workflowInstanceId: "<same-as-data.save>", workItemId: "<same-as-data.save>" } },
+    refusalRecovery: [
+        { code: "submit-biz-object-id-required", action: "把 data.save 的 bizObjectId 原样传给 data.submit" },
+        { code: "submit-existing-workflow-unsupported", action: "不要用旧行 + workflowCode 启动；先 data.save 新建 DRAFT，再用返回 workItemId 提交" },
+        { code: "submit-target-absent", action: "用 data.load 确认 bizObjectId 属于 schemaCode 后停止盲重试" },
+        ...commonRecovery,
+    ],
+    requiresEnvironmentDerivedIds: true,
+    prerequisiteData: { source: "data.save authoritative readback; workitem.list fallback", fields: ["bizObjectId", "workflowInstanceId", "workItemId"] },
+});
+const dataListFilter = Object.freeze({
+    id: "list-filter-equality",
+    title: "按等值条件读一批业务数据（filter DSL 的可运行最小形状）",
+    status: "offline-valid",
+    tool: "data.list",
+    args: { environment, schemaCode: model, filter: { op: "eq", field: "status", value: "OPEN" }, size: 20 },
+    preconditions: ["schemaCode 的字段已 field.publish（filter 叶子的 propertyType 从发布面读）"],
+    conditionalRequirements: [
+        "filter 是**一个**子句 `{op, field, value?}`；op ∈ eq/neq/gt/lt/gte/lte/like/notlike/in/notin/between/notbetween/isnull/isnotnull（camelCase 别名 equals/notEquals/contains/isNull/isNotNull 等价——r36 体检发现别名合法但只列规范名会被误判『静默接受坏 op』）。",
+        "多条件 `filters:[…]`（AND）；分组 `filterGroup:{op:'and'|'or',clauses:[…]}`；系统/外部字段用 rawCondition。",
+    ],
+    priorToolReferences: [
+        { tool: "field.list", args: { environment, schemaCode: model, published: true }, purpose: "确认要过滤的字段 code 已发布" },
+    ],
+    dryRun: { supported: false, command: `omc call data.list --env ${environment} --args '<recipe.args>'`, notes: "只读，无 dry-run；直接调用即读回" },
+    expectedReadback: { readback: { total: 1, rows: "…" } },
+    refusalRecovery: [{ code: "invalid-filter-DSL", action: "按错误里的 minimalValidFilter/acceptedOps 修正 op/field/value" }],
+    requiresEnvironmentDerivedIds: false,
+});
+const dataDeleteSweep = Object.freeze({
+    id: "sweep-all-readback",
+    title: "清空模型数据并权威验证（list 取 ids → delete → 复验 total:0）",
+    status: "offline-valid",
+    tool: "data.delete",
+    args: { environment, schemaCode: model, bizObjectIds: ["<data.list 逐条 id>"] },
+    preconditions: [
+        "先 data.list 取全量 ids（page 0 起、size 够大或翻页）；**submit 后平台会同时保留 DRAFT 与 COMPLETED 两类行（r30 实证 5 次提交 = 10 行），清理对象按 data.list 全量**",
+    ],
+    conditionalRequirements: [
+        "参数名是 `bizObjectIds`（数组）——不是 ids/bizObjectId（单条删除另有其参）",
+        "id 已被删时幂等 no-op，重复清理安全",
+    ],
+    priorToolReferences: [
+        { tool: "data.list", args: { environment, schemaCode: model }, purpose: "取全量 bizObjectIds（含 DRAFT 行）" },
+    ],
+    dryRun: { supported: true, command: `omc call data.delete --env ${environment} --dry-run --args '<recipe.args>'`, notes: "dry-run 出删除计划不落库" },
+    expectedReadback: { readback: { deleted: "N", modelResidue: { total: 0 } }, next: ["data.list 复验 total:0 / items:[]（权威清空判据）"] },
+    refusalRecovery: [{ code: "wire-business", action: "模型须已创建且有已发布字段；运行面 50000 时先 model.inspect modelPresent 判存在" }],
+    requiresEnvironmentDerivedIds: false,
+});
+export const RUNTIME_DATA_METADATA = Object.freeze({
+    "data.save": Object.freeze({ recipes: [workflowSave], relatedTools: ["workflow.get_published", "data.submit", "workitem.list"] }),
+    "data.submit": Object.freeze({ recipes: [plainSubmit, workflowSubmit], relatedTools: ["data.save", "workitem.list", "data.load"] }),
+    "data.list": Object.freeze({ recipes: [dataListFilter], relatedTools: ["data.load", "data.delete", "listview.configure", "field.list"] }),
+    "data.delete": Object.freeze({ recipes: [dataDeleteSweep], relatedTools: ["data.list", "data.load", "data.submit"] }),
+});
+//# sourceMappingURL=runtime-data.js.map

package/dist/recipes/shared.js

@@ -0,0 +1,8 @@
+// 配方共享占位符与公共恢复项（唯一事实源——各 lane 配方从这里 import，勿复制防漂移）。
+export const commonRecovery = Object.freeze([
+    Object.freeze({ code: "tool-input-invalid", action: "修正 recipe.args 后重新 dry-run；inputSchema 是参数权威" }),
+    Object.freeze({ code: "write-lock-held", action: "等待当前写锁释放后重试；不要并行重放写入" }),
+]);
+export const environment = "<environment>";
+export const model = "omc_recipe_model";
+//# sourceMappingURL=shared.js.map