@stalfh233/omc-cli 0.4.94 → 0.4.95

package/dist/compute.js

@@ -106,6 +106,38 @@ export function composeComputeArgs(options) {
         dryRun: !options.apply,
     };
 }
+/**
+ * The receipt for a `compute --apply` must not imply the rule will fire.
+ *
+ * 0.4.95 source evidence (8.6.26):
+ *  - a type-2 rule whose carrier is `shortTextStitch` runs only when
+ *    `CalcSwitchConf.forceExecuteCalculateRule` is true
+ *    (`CalculateHandler.onHandler`, 8.6.26 :50);
+ *  - that flag comes from `BizObjectOptions.executeCalRule`
+ *    (`BizObjectOpConf.constructCalcSwitchConf` :95), and the only builder that
+ *    sets it (`.executeCalRule()`) has NO caller in the tree — only the
+ *    open-engine API can pass it.
+ * So data.save / data.submit / data.update never refresh the target field.
+ * r12 believed otherwise; r16 could not reproduce r12's success.
+ */
+export function computeExecutionNotice() {
+    return {
+        executionWarning: "字段计算规则已写入，但**提交/更新不会触发它**：type2 的 shortTextStitch 载体只在 " +
+            "CalcSwitchConf.forceExecuteCalculateRule=true 时求值，该开关来自 BizObjectOptions.executeCalRule，" +
+            "而 8.6.26 全代码库没有任何 REST 路径把它置真（.executeCalRule() 仅 open-engine 显式 API 使用）。" +
+            "所以 data.save / data.submit / data.update 都不会刷新目标字段。",
+        executionEvidence: [
+            "BizObjectManagerImpl.java:377,424 — calculateHandler.onHandler(settings.getCalcSwitchConf(), …)",
+            "CalculateHandler.java:50 — if (switchConf.isForceExecuteCalculateRule())",
+            "BizObjectOpConf.java:95 — setForceExecuteCalculateRule(options.isExecuteCalRule())",
+            "engine/bizobject/BizObjectOptions.java:58 — 唯一的 executeCalRule() builder，全库无调用方",
+        ],
+        aggregationPathNote: "子表聚合的正解是 AGGREGATION 形状（options.formulaType=\"AGGREGATION\" + aggregation），它走 " +
+            "FormulaPropertySupport.onTriggerObjectChanged 的事件回算，不依赖 executeCalRule。" +
+            "0.4.95 取证时该形状仍未跑通（平台把 JSON 绑定失败掩码成 305003「死循环」），因此 OMC 暂不提供；" +
+            "在补齐前不要用字段计算规则做服务端聚合，改用 business rule 或二开接口。",
+    };
+}
 export async function cmdCompute(args) {
     const request = requestId();
     const flag = (name) => argvValue(args, name);
@@ -121,6 +153,7 @@ export async function cmdCompute(args) {
     const usage = [
         "用法：omc compute --schema <模型code> --target <目标字段> --formula \"<公式，{字段} 引用>\" [--name 规则名] [--env 环境] [--apply]",
         "条件聚合：--formula \"{<子表code>.<子列code>}\" --where \"<子列code> = <值>\" [--aggregate count|sum]  → 编译为 COUNTIF / SUMIF",
+        "⚠️ 但 1.1.25 上这条规则**不会**被 data.save/submit/update 触发（源码取证：type2 的 shortTextStitch 载体只在 executeCalRule=true 时执行，而 REST 路径从不置真）。子表聚合的正解是 AGGREGATION 形状，OMC 尚未做对；见 --apply 回执的 executionWarning。",
         "公式语法：同类字段 {字段code}；子表列 {子表code.子列code}；无条件聚合 SUM/COUNT/MAX/MIN/AVG({子表.子列}) 需加 --allow-unfiltered 显式确认。",
         "默认 dry-run，--apply 才写入。",
     ].join("\n");
@@ -167,7 +200,16 @@ export async function cmdCompute(args) {
         return CLI_EXIT_CODES.internal;
     }
     const classified = classifyResult(result);
-    writeEnvelope(envelope(classified.status, result, request, classified.error));
+    // 0.4.95 source-verified: a type-2 rule whose carrier is `shortTextStitch`
+    // (what this command writes) is executed ONLY when
+    // `CalcSwitchConf.forceExecuteCalculateRule` is true. That flag comes from
+    // `BizObjectOptions.executeCalRule`, and `.executeCalRule()` is never called
+    // anywhere in the 8.6.26 tree — only the open-engine API can pass it. So
+    // data.save / data.submit / data.update never refresh the target field, no
+    // matter how correct the formula is. Say so in the receipt instead of letting
+    // the caller believe the write took effect (r12 believed it; r16 disproved it).
+    const withWarning = apply && classified.status === "ok" ? { ...result, ...computeExecutionNotice() } : result;
+    writeEnvelope(envelope(classified.status, withWarning, request, classified.error));
     return exitCode;
 }
 //# sourceMappingURL=compute.js.map

package/package.json

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