@stalfh233/omc-cli 0.4.19 → 0.4.21

package/dist/lanes/businessrule-contract.js

@@ -144,7 +144,7 @@ export const BUSINESSRULE_LANE_CONTRACT = Object.freeze({
     tools: Object.freeze({
         "rule.list": Object.freeze({
             scope: "latest rule business-field listing",
-            description: "列出某模型的最新业务规则版本，回显 enabled/status/developmentMode/ruleVersion 等业务字段；服务端不过滤，客户端自行筛选。",
+            description: "列出某模型的最新业务规则版本。默认行=清单面（code/name/enabled/status/ruleVersion/defaultRule——defaultRule:true 是平台预置触发行，客户端自滤）；id/createdTime/creator/developmentMode 等审计列走 full:true。服务端不过滤。",
         }),
         "rule.get": Object.freeze({
             scope: "rule node route readback",

package/dist/lanes/businessrule.js

@@ -51,28 +51,41 @@ export function registerBusinessRuleLane(tools) {
         inputSchema: {
             environment: environmentArg,
             schemaCode: z.string().min(1),
-            full: z.boolean().optional().describe("内联完整规则列表；默认只返回摘要与 detailFile"),
+            full: z.boolean().optional().describe("行内联完整字段（id/createdTime/creator/…，并跳过 detailFile 外置）；默认行只有 code/name/enabled/status/ruleVersion/defaultRule/latestPublished——平台预置触发行（defaultRule:true）客户端自滤"),
             capability: capabilityArg,
         },
         handler: async (ctx, args, self) => governedRead(ctx, self, args, async (session) => {
             const rows = wireRows((await wireCall(session, { path: ENDPOINTS.runtimeBusinessRuleListBySchemaCode, query: { schemaCode: args.schemaCode } })).data);
+            // N2 (r10 noise pass): the default row is the inventory face —
+            // code/name/state/publish-version/is-preset. The audit columns
+            // (id/createdTime/creator/developmentMode/templateType/…) only ride
+            // with full:true (the old 14-key row). rule.get resolves by business
+            // key (schemaCode+ruleCode), so the row id is rarely needed.
+            const fullRows = args.full === true;
             return {
                 schemaCode: args.schemaCode,
                 rules: rows.map((row) => ({
-                    id: row.id,
                     code: row.code,
                     name: row.name,
-                    schemaCode: row.schemaCode,
-                    bizRuleType: row.bizRuleType,
                     enabled: row.enabled,
                     status: row.status,
-                    developmentMode: row.developmentMode,
-                    ruleVersion: row.ruleVersion,
-                    latestPublished: row.latestPublished,
-                    templateType: row.templateType,
-                    defaultRule: row.defaultRule,
-                    createdTime: row.createdTime,
-                    creator: row.creater ?? row.creator,
+                    ...(row.ruleVersion !== undefined ? { ruleVersion: row.ruleVersion } : {}),
+                    ...(row.defaultRule !== undefined ? { defaultRule: row.defaultRule } : {}),
+                    // ticket-80's update-mode readback teaches following the same-code
+                    // latestPublished row — keep the flag on the default face (5 B).
+                    ...(row.latestPublished !== undefined ? { latestPublished: row.latestPublished } : {}),
+                    ...(fullRows
+                        ? {
+                            id: row.id,
+                            schemaCode: row.schemaCode,
+                            bizRuleType: row.bizRuleType,
+                            developmentMode: row.developmentMode,
+                            latestPublished: row.latestPublished,
+                            templateType: row.templateType,
+                            createdTime: row.createdTime,
+                            creator: row.creater ?? row.creator,
+                        }
+                        : {}),
                 })),
             };
         }, { full: args.full === true, target: `rule.list:${args.schemaCode}` }),

package/dist/lanes/field-contract.js

@@ -161,7 +161,7 @@ export const FIELD_LANE_CONTRACT = Object.freeze({
     tools: Object.freeze({
         "field.list": Object.freeze({
             scope: "create publish readback",
-            description: "List draft/published fields of a model, each with its parsed options (readback face of the field family chain).",
+            description: "List draft/published fields of a model. 默认清单面：code/name/type(+typeName)/conditions 信号/shapeWarning——选项族整包 choices 不内联（实测选择字段 ~500B/行）；验证 options/subSchema 用 code/fields 选择器或 full:true（readback face of the field family chain）。",
         }),
         "field.create": Object.freeze({
             scope: "create publish readback",

package/dist/lanes/field.js

@@ -75,7 +75,7 @@ export function registerFieldLane(tools) {
         lane: FIELD_LANE,
         scope: FIELD_TOOLS["field.list"].scope,
         description: FIELD_TOOLS["field.list"].description,
-        inputSchema: { environment: environmentArg, schemaCode: z.string(), published: z.boolean().default(false), code: z.string().optional(), fields: z.array(z.string()).optional(), all: z.boolean().optional().describe("默认只返业务字段（过滤 SYSTEM_FIELD_CODES 的 13 个平台字段：id/name/sequenceNo/createdTime/creater/sequenceStatus/…）；true 连系统字段一起返"), capability: capabilityArg },
+        inputSchema: { environment: environmentArg, schemaCode: z.string(), published: z.boolean().default(false), code: z.string().optional(), fields: z.array(z.string()).optional(), full: z.boolean().optional().describe("行内联完整 options/subSchema；默认清单面只有 code/name/type/typeName(+conditions 信号/shapeWarning)，验证 options 用 code/fields 选择器或 full:true"), all: z.boolean().optional().describe("默认只返业务字段（过滤 SYSTEM_FIELD_CODES 的 13 个平台字段：id/name/sequenceNo/createdTime/creater/sequenceStatus/…）；true 连系统字段一起返"), capability: capabilityArg },
         handler: async (ctx, args, self) => governedRead(ctx, self, args, async (session) => {
             const rows = wireRows((await wireCall(session, { path: ENDPOINTS.fieldList, query: { schemaCode: args.schemaCode, isPublish: args.published ? "true" : "false" } })).data);
             const mapped = rows.map((row) => {
@@ -103,13 +103,44 @@ export function registerFieldLane(tools) {
             // (which token-diets to {count,sha256} past 4 KB) through an artifact.
             const selector = [args.code, ...(args.fields ?? [])].filter((entry) => typeof entry === "string" && entry.length > 0);
             const selected = selector.length > 0 ? mapped.filter((field) => selector.includes(String(field.code))) : mapped;
+            // N1 (r10 noise pass): the DEFAULT face is the inventory — code/name/
+            // type(+condition signal/shapeWarning). Options arrays (choices carry
+            // their full custom lists inline, ~500B per selection field measured)
+            // only echo for a code/fields selector or full:true. Same shape the
+            // >4KB window diet already served; promoted to the default so small
+            // models stop paying option bytes on inventory reads.
+            const detailed = selector.length > 0 || args.full === true;
             // Round 10: the default face is BUSINESS fields only — 13 of 21 fields on a
             // typical model are platform system fields, so a caller asking "what fields
             // does this model have" paid for noise it then had to filter. `all:true`
             // restores the previous full list (uses the SAME SYSTEM_FIELD_CODES set the
             // list-view/form scaffolds already filter with).
             const visible = args.all === true ? selected : selected.filter((field) => !SYSTEM_FIELD_CODES.has(String(field.code)));
-            return { schemaCode: args.schemaCode, published: args.published === true, ...(selector.length > 0 ? { selected: selector } : {}), ...(args.all !== true ? { businessOnly: true } : {}), fields: visible };
+            const projected = detailed
+                ? visible
+                : visible.map((field) => {
+                    const options = (field.options ?? {});
+                    const conditions = Object.keys(FORM_CONDITION_OPTION_KEYS).filter((key) => {
+                        const value = options[key];
+                        return key === "readonlyFormula" ? value === true : typeof value === "string" && value.trim() !== "";
+                    });
+                    return {
+                        code: field.code,
+                        type: field.type,
+                        ...(field.typeName !== undefined ? { typeName: field.typeName } : {}),
+                        ...(field.name !== undefined ? { name: field.name } : {}),
+                        ...(conditions.length > 0 ? { conditions } : {}),
+                        ...(field.shapeWarning !== undefined ? { shapeWarning: field.shapeWarning } : {}),
+                    };
+                });
+            return {
+                schemaCode: args.schemaCode,
+                published: args.published === true,
+                ...(selector.length > 0 ? { selected: selector } : {}),
+                ...(args.all !== true ? { businessOnly: true } : {}),
+                fields: projected,
+                ...(detailed ? {} : { inventory: true, hint: '字段详情（options/subSchema）用 code/fields 选择器或 full:true' }),
+            };
         }, {
             // Round 4: the default diet reduced the whole list to a count, so agents
             // fetched the 28 KB artifact just to read field codes (benchmark: 4×28 KB).
@@ -117,6 +148,11 @@ export function registerFieldLane(tools) {
             // warning). `options` stays out — use code/fields selector for that.
             target: `field.list:${args.schemaCode}:${args.published === true ? "published" : "draft"}`,
             compact: (result) => {
+                // N1: the handler's DEFAULT face is already the inventory projection;
+                // re-projecting here would strip the conditions signal (options are
+                // gone by design). Pass it through untouched.
+                if (result.inventory === true)
+                    return result;
                 const fields = Array.isArray(result.fields) ? result.fields : [];
                 return {
                     schemaCode: result.schemaCode,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stalfh233/omc-cli",
-  "version": "0.4.19",
+  "version": "0.4.21",
   "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.19",
+    "omc-core": "0.4.21",
     "proper-lockfile": "4.1.2",
     "write-file-atomic": "6.0.0",
     "zod": "^3.23.8",

package/skills/omc-write-hazards.md

@@ -24,7 +24,7 @@ omc help omc-write-hazards
 ## 模型字段与关联
 
 - **code 定位写前先核在册**：`field.update` / `rule.node.update` 等按 code 定位的精确写，先 `model.inspect` / `field.list` 确认 code 在册；缺码即停并报"目标不存在 + 当前字段清单"——**别凭用户措辞假定 code 正确**（用户可能记错字段名），**也别擅自替换成语义相近的字段**（改错对象比不改更糟）。缺码 `field.update` 本就拒 301001，但写前先核能省一轮失败往返，并在草稿阶段就把"字段不存在"与"需求理解偏差"分清。
-- **改名核对以字段读为准**：`field.update` 改名后，`model.inspect` 聚合面的 `fields[].name` 可能仍是旧值（发布态快照/聚合缓存）；核对显示名、options 一律用 `field.list` / `field.get` 或 `form.publish` 回读——两处读数不一致时以字段读为准，别误判"写入没生效"而重复写。
+- **改名核对以字段读为准**：`field.update` 改名后，`model.inspect` 聚合面的 `fields[].name` 可能仍是旧值（发布态快照/聚合缓存）；核对显示名用 `field.list`（默认清单面有 name）；核对 options 用 `field.list` 的 `code` 选择器 / `field.get` 或 `form.publish` 回读——两处读数不一致时以字段读为准，别误判"写入没生效"而重复写。
 - `propertyEmpty` 默认 `false`。模型层保持可空；必填、只读、可见性在表单和流程节点配置。
 - 无映射关联单选 `WORK_SHEET` 使用 `mappings: ""`，不要用 `"[]"`。`"[]"` 是非空字符串，设计器会显示“已设置”，但弹窗没有映射行。
 - 有映射时传非空 JSON 数组字符串，并在 draft/published 两面读回。