@stalfh233/omc-cli 0.5.5 → 0.5.6

package/dist/field-families.js

@@ -341,6 +341,12 @@ function orgSelectorControlOptions(base, deptVisible, multi) {
  * previous behaviour) left the control with an unrecognised format, so the
  * portal rendered the raw decimal. Derive the constant from the field's
  * `scale` (0-based decimal places) and `format` family.
+ *
+ * NAMING TRAP (2026-10-30 field report "数值怎么变成百分比了"): `percentile`
+ * here is 百分位 = TWO DECIMALS (`2,000.00`), NOT percentage. The platform's
+ * own control API documents the scale as none / integer(200) / tenths(2,000.0)
+ * / percentile(2,000.00) / ratio(20%) / ratio.tenths(20.0%) /
+ * ratio.percentile(20.00). Percentage is spelled with the `ratio` word.
  */
 const NUMERICAL_DECIMALS_FORMAT = Object.freeze({
     0: "integer",
@@ -353,6 +359,16 @@ const NUMERICAL_DECIMALS_FORMAT = Object.freeze({
     7: "tenMillionDecimals",
     8: "billionDecimals",
 });
+/**
+ * Ratio formats only exist as bare `ratio`, `ratio.tenths`, `ratio.percentile`
+ * (platform control API); `ratio.integer` / `ratio.Millimeter` are not
+ * documented values, so a percent field clamps to the closest documented one.
+ */
+const RATIO_DECIMALS_FORMAT = Object.freeze({
+    0: "ratio",
+    1: "ratio.tenths",
+    2: "ratio.percentile",
+});
 function numericalFormatPrefix(format) {
     const value = String(format ?? "").toLowerCase();
     if (value === "currency" || value === "rmb" || value === "¥")
@@ -369,8 +385,16 @@ function numericalFormatPrefix(format) {
 }
 export function numericalControlFormat(fieldOptions) {
     const scale = fieldOptions?.scale;
-    const decimals = isNumericalScale(scale) ? scale : 2;
-    return `${numericalFormatPrefix(fieldOptions?.format)}${NUMERICAL_DECIMALS_FORMAT[decimals]}`;
+    // Absent/invalid scale: the platform default is `integer` — every native
+    // numeric control sampled in a live tenant carries it (2026-10-30: 10 models,
+    // 20+ controls, all `integer`). Defaulting to 2 (`percentile`) made a form
+    // rebuild silently turn existing integer money fields into "2,000.00".
+    const valid = isNumericalScale(scale);
+    const decimals = valid ? scale : 0;
+    const prefix = numericalFormatPrefix(fieldOptions?.format);
+    if (prefix === "ratio.")
+        return RATIO_DECIMALS_FORMAT[Math.min(decimals, 2)];
+    return `${prefix}${NUMERICAL_DECIMALS_FORMAT[decimals]}`;
 }
 export function fieldControlOptions(type, name, relativeCode, relationMappings, relationDisplayField = "name", fieldOptions) {
     const base = { name, name_i18n: { "zh-CN": name, en: name }, visible: true, labelVisible: true, span: 24 };

package/dist/recipes/field.js

@@ -101,7 +101,7 @@ const numericTwoDecimals = Object.freeze({
     title: "数值字段（金额，两位小数 / 整数）— scale 必填",
     status: "offline-valid",
     tool: "field.create",
-    args: { environment, schemaCode: model, code: "applyAmount", name: "申请金额", propertyType: "NUMERICAL", options: { scale: 3 } },
+    args: { environment, schemaCode: model, code: "applyAmount", name: "申请金额", propertyType: "NUMERICAL", options: { scale: 2 } },
     preconditions: ["模型已存在"],
     conditionalRequirements: ["NUMERICAL 必须显式 options.scale：scale = 小数位数（0=整数, 1=1位, 2=2位 … 8=8位）；缺 scale 门户显示裸 decimal 且工具会拒绝。"],
     priorToolReferences: [{ tool: "discover_environment", args: { environment }, purpose: "确认目标模型已存在" }],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stalfh233/omc-cli",
-  "version": "0.5.5",
+  "version": "0.5.6",
   "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.5",
+    "@stalfh233/omc-fake-platform": "0.5.6",
     "commander": "14.0.3",
-    "omc-core": "0.5.5",
+    "omc-core": "0.5.6",
     "proper-lockfile": "4.1.2",
     "write-file-atomic": "6.0.0",
     "zod": "^3.23.8",

package/skills/omc-business-configuration.md

@@ -141,6 +141,7 @@ rules:
 - rebuild 会保留已识别的关系映射、显示和布局 options；Sheet201 columns 按最新子表字段刷新。
 - **配置列表视图用 `listview.configure`（省略 `code` 即平台自动生成的默认视图 code=schemaCode），不要先 `listview.create`——那会多出一个视图。** 只有确实要第二个视图才 create；两者职责分开。
 - 数值控件：`scale` 是小数位数（0=整数,1=1位,2=2位…）；「金额两位小数」用 `scale:2`。列表列 displayFormat 由 scale 推导。
+- **`percentile` 不是百分比**（高频误读，2026-10-30 现场反馈）：表单控件的 `format` 里 `integer`(200) / `tenths`(2,000.0) / `percentile`(2,000.00) 都是小数位；**百分比要带 `ratio` 词**——`ratio`(20%) / `ratio.tenths`(20.0%) / `ratio.percentile`(20.00)，货币用 `RMB.*`/`dollar.*`。字段行 `options.format` 缺 `scale` 时控件按平台默认 `integer` 生成（不是两位小数），所以「金额」务必显式 `scale:2`。
 - **列表列只放业务字段**：平台 `listview.create` 会预置系统列（`name/creater/createdTime/sequenceNo`）和一条 `createdTime` 默认筛选；intent 的 `fieldCodes` 是权威集合，编译器用 `replaceColumns:true + hideDefaultSystemFields:true + conditions:[]` 清掉预置项。要展示某系统列/筛选就显式点名。
 - 筛选条件默认显示：`conditions[].visible` 不传也应为 true。
 - 配置默认视图后即可用 `data.list`；否则部分 8.6.26 读面业务列可能为 null，单行用 `data.load` 核对。