@stalfh233/omc-cli 0.4.28 → 0.4.29

package/dist/lanes/runtime-data.js

@@ -548,7 +548,7 @@ export function registerRuntimeDataLane(tools) {
         sheetCode: z.string().optional(),
         formData: runtimeFormDataArg,
         workflowCode: z.string().optional().describe("portal draft-save shape: create the row AND a DRAFT workflow instance + start workItem (finishStart=FALSE); submit later via data.submit with the returned workItemId. formData must NOT carry an id — in-place workflow start has no REST surface in 8.6.26"),
-        submit: z.boolean().optional().describe("r18 retro：true=一调完成态——保存后立即直提（无流程模型 DRAFT→COMPLETED，触发 Create 业务规则）；与 workflowCode 互斥（流程草稿须走 data.submit 两段式）。默认 false 仅存草稿"),
+        submit: z.boolean().optional().describe("true=保存后立即直提（无流程模型 DRAFT→COMPLETED，触发 Create 规则）；与 workflowCode 互斥。**按业务约定正式数据优先直接 data.submit（无 id=新建并提交一调完成）——本参数是便捷别名，save 的定位是草稿/暂存**"),
         ...readbackProjectionArgs,
     }, async (session, args) => {
         // F-A (self-audit): the combo used to be silently ignored (the workflow

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stalfh233/omc-cli",
-  "version": "0.4.28",
+  "version": "0.4.29",
   "description": "CloudPivot 8.6 configuration capability CLI — governed, fail-closed, coverage-manifest bounded.",
   "type": "module",
   "bin": {
@@ -51,7 +51,7 @@
   },
   "dependencies": {
     "commander": "14.0.3",
-    "omc-core": "0.4.28",
+    "omc-core": "0.4.29",
     "proper-lockfile": "4.1.2",
     "write-file-atomic": "6.0.0",
     "zod": "^3.23.8",

package/skills/omc-capabilities.md

@@ -171,10 +171,11 @@ only the section for the capability you need —
 - **recipe**：
   - `omc describe data.save --example workflow-backed-data-save`
   - `omc describe data.submit --example workflow-backed-data-submit`（有流程）
-  - 无流程模型的规则验证路径（两选）：
-    - 一调：`data.save {schemaCode, formData, submit:true}` ——保存+直提 COMPLETED，触发 Create 规则（模型有已发布流程时会拒绝并指路两段式）
-    - 两步：`data.save`（DRAFT）→ `data.submit {schemaCode, bizObjectId, formData}` ——示例 `omc describe data.submit --example plain-data-submit`
-    - 流程模型：`data.save {workflowCode}`（返回 workItemId）→ `data.submit {bizObjectId, workflowInstanceId, workItemId}`（workflow-backed-data-submit）
+  - **正式数据一律 data.submit**（业务约定；save 的新建永远是 DRAFT 草稿）：
+    - 无流程模型一调：`data.submit {schemaCode, formData}`（无 id=新建并提交，COMPLETED，触发 Create 规则）——示例 `omc describe data.submit --example plain-data-submit`
+    - 已存草稿直提：`data.submit {schemaCode, bizObjectId, formData}`
+    - 流程模型两段式：`data.save {workflowCode}`（返回 workItemId）→ `data.submit {bizObjectId, workflowInstanceId, workItemId}`（workflow-backed-data-submit）
+    - `data.save` 定位=草稿/暂存；其 `submit:true` 便捷参数仍在（无流程模型等同直提），但按约定优先直接 data.submit
 - **边界 / 陷阱**：读实际业务记录是 OMC 独有能力。**计算字段（FORMULA/子表计算）不由 API 回填**——写测试数据带预算值，公式正确性人工前台确认；带子表计算字段的模型 API 写可能 50000（服务端重算 NPE），前台正常。
 
 ---