@stalfh233/omc-cli 0.5.4 → 0.5.6

package/dist/cli.js

@@ -1073,6 +1073,10 @@ async function cmdGraphPull(environment, concurrency, transport) {
             status: "ok",
             environment: data.meta.environmentName,
             applicationCode: data.meta.applicationCode,
+            // The index covers ONE application. Echo where it came from, so a
+            // zero-hit query against a 1-of-N slice cannot read as tenant-wide
+            // absence (same contract as model.list / rule.references).
+            ...(data.meta.applicationResolution ? { applicationResolution: data.meta.applicationResolution } : {}),
             identityFingerprint: data.meta.identityFingerprint,
             pulledAtIso: data.meta.pulledAtIso,
             scope: data.meta.scope,

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/graph.js

@@ -380,6 +380,18 @@ export async function pullRuleGraph(session, concurrency = DEFAULT_PULL_CONCURRE
         timings: { listMs, readMs, totalMs: Date.now() - totalStart },
     };
 }
+/** Parse the persisted `applicationResolution` meta row; a malformed row degrades to undefined. */
+function parseApplicationResolution(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.code !== "string" || typeof parsed.source !== "string")
+            return undefined;
+        return parsed;
+    }
+    catch {
+        return undefined;
+    }
+}
 function ensureGraphDir() {
     const dir = dirname(graphDbPath());
     mkdirSync(dir, { recursive: true, mode: 0o700 });
@@ -480,8 +492,11 @@ export async function publishGraphPull(session, concurrency = DEFAULT_PULL_CONCU
         CREATE TABLE gaps (kind TEXT NOT NULL, ref TEXT NOT NULL, note TEXT);
       `);
                 const insertMeta = db.prepare("INSERT INTO meta (key, value) VALUES (?, ?)");
+                // `applicationResolution` is an object; String(value) would persist
+                // "[object Object]" (2026-10-30: the field was written and unreadable).
+                // JSON-encode structured values, keep scalars verbatim.
                 for (const [key, value] of Object.entries(data.meta))
-                    insertMeta.run(key, String(value));
+                    insertMeta.run(key, typeof value === "object" && value !== null ? JSON.stringify(value) : String(value));
                 const insertRule = db.prepare("INSERT INTO rules (schema_code, rule_code, name, enabled, status, default_rule, row_id, graph_sha256) VALUES (?, ?, ?, ?, ?, ?, ?, ?)");
                 for (const rule of data.rules)
                     insertRule.run(rule.schemaCode, rule.ruleCode, rule.name, rule.enabled === null ? null : rule.enabled ? 1 : 0, rule.status, rule.defaultRule === null ? null : rule.defaultRule ? 1 : 0, rule.rowId, rule.graphSha256);
@@ -545,6 +560,9 @@ function openGraphIndex() {
             summary: {
                 environmentName: meta.environmentName ?? "",
                 applicationCode: meta.applicationCode ?? "",
+                // Persisted as JSON by the writer; a legacy index (pre-0.5.4) has no
+                // such key, so this stays optional rather than failing the read.
+                ...(meta.applicationResolution ? { applicationResolution: parseApplicationResolution(meta.applicationResolution) } : {}),
                 identityFingerprint: meta.identityFingerprint ?? "",
                 pulledAtIso: meta.pulledAtIso ?? "",
                 freshness: gapCount === 0 ? "complete" : "partial",

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.4",
+  "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.4",
+    "@stalfh233/omc-fake-platform": "0.5.6",
     "commander": "14.0.3",
-    "omc-core": "0.5.4",
+    "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` 核对。