@stalfh233/omc-cli 0.4.99 → 0.4.101

package/package.json

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

package/skills/omc-capabilities.md

@@ -95,7 +95,7 @@ only the section for the capability you need —
   - **跨模型汇总可以用 FORMULA(100) + AGGREGATION，REST 能回算**（r17 真机 100→105）：`omc describe field.create --example formula-aggregation-cross-model`；`queryConditions` 必须给 DYNAMIC 条件（propertyCode=来源字段、currentPropertyCode=目标字段），空条件静默得 0。
   - **同模型（含自己的子表）聚合不可用**：`field.publish` 必抛 305003（`aggregation-self-schema-cycle`，平台 `checkCycleOfAggregation:1032` 逻辑成环）。
   - 只有 `FORMULA`（计算公式，`propertyType:100`）字段是**门户前端**计算、API 不回填（旧证据 2026-09-25/10-07，仅覆盖该字段类型）。
-  - 子表列支持标量族 + WORK_SHEET 关联列（需 `relativeCode`+options）；**嵌套子表 / MULT_WORK_SHEET / RELEVANCE_DATA 不覆盖**。
+  - 子表列支持标量族 + WORK_SHEET 关联列（需 `relativeCode`+options）；**子表套子表平台本身不存在**（一级子表就是上限），`MULT_WORK_SHEET` / `RELEVANCE_DATA` 不覆盖。
 
 ## 默认表单 `form`
 
@@ -130,7 +130,7 @@ only the section for the capability you need —
 ## 业务规则 `businessrule`
 
 - **能做哪些事**：图形规则图（nodeGraph）——数据事件（Create/Update/Delete）触发、按钮/流程触发、动作节点（UPDATE/CREATE/DELETE/QUERY/ASSIGN/MESSAGE/BIZ_ACTION/GET_LIST…）、BRANCH 条件分支、**定时任务 TIMING_TASK**（每天/周期，SCHEDULER 节点）。
-- **工具**：`rule.list`、`rule.get`、`rule.save`、`rule.node.update`
+- **工具**：`rule.list`、`rule.get`、`rule.references`（跨规则引用检索：谁引用了服务/模型/字段）、`rule.save`、`rule.node.update`
 - **recipe**：
   - `omc describe rule.save --example standard-business-rule-graph`
   - `omc describe rule.save --example business-rule-branch-conditional`
@@ -199,7 +199,7 @@ only the section for the capability you need —
 | 面 | 状态 | 说明 |
 | --- | --- | --- |
 | 权限 / 授权矩阵 | blocked | 授权矩阵不在配置面 |
-| 嵌套子表（子表套子表） | blocked | 一级子表可用，嵌套不可 |
+| 嵌套子表（子表套子表） | 平台不存在 | 平台本身就是一级子表：主表可多子表，子表不能再套子表；不是 CLI 缺口，不要按此设计 |
 | OCR / 电子签章 / 发票识别 | unsupported | 不在平台配置覆盖内 |
 | 应用发布 / 环境上线 / 生产发布 | unsupported | CLI 只做配置，不做环境发布 |
 | 在线后端编码 / EXECUTE_CODE / ONLINE_DEVELOP | unsupported | 用二开扩展包，不用在线 JS 伪造 |

package/skills/omc-refusals.md

@@ -40,7 +40,7 @@ usually carries `validation` entries to fix one by one.
 - `business-code-invalid`, `duplicate-field`, `duplicate-service`,
   `dictionary-create-duplicate`, `app-create-duplicate`, `model-create-duplicate`
 - `field-*` family gates (unaccepted family, missing relation `relativeCode`,
-  nested child table, OCR/ELECTRONIC_SIGN)
+  child-table column that is itself a child table, OCR/ELECTRONIC_SIGN)
 - `form-layout-invalid`, `form-fieldcodes-unknown`, `form-html-render-invalid`
 - `rule-graph-validation-failed`, `rule-graph-*` (node-graph dry lint)
 - `datarule-options-invalid`, `datarule-property-not-published`, `datarule-duplicate-property-type`

package/skills/omc-start-here.md

@@ -26,7 +26,7 @@ be treated as a second source. Read this, then follow the topics it names.
    - `build`/`modify` → 按阶梯内联的**写工具 + 必填参数**执行。
    - `scout`（能不能/怎么写/是否支持）→ 先探边界（`omc-capability-scouting`），别直接写。若 `next` 返回 **`boundary`**（`match.kind:"boundary"`，如 `ocr-e-signature`/`release-prod`/`inline-coding`），说明需求**不在覆盖内**（`write:false`）：如实报告、用 `omc capabilities` 核对，**不要**用相近能力伪造实现。
    阶梯步骤已内联工具必填参数（`route.ladder[].tools`/`readTools`）与命中 recipe 的 `describe <tool> --example <id>`；据此直接执行——**不要再逐能力 `commands --lane`**，也不要先扫 `commands --json`/全部 `contract`/全部 `describe --full`。
-   方法论按 `route.readSections` 逐节读：对每条 `{topic, section}` 执行 `omc help <topic> --section "<section>"`（单节 0.4–3.4KB）。`omc help <topic>` 默认只回节索引（约 1KB，含每节字节数）；**不要 `--all` 读整篇**（5–14KB，读一次就留在后续每一轮窗口）。
+   方法论按 `route.readSections` 逐节读：对每条 `{topic, section}` 执行 `omc help <topic> --section "<section>"`（单节 0.4–3.4KB）。`omc help <topic>` 默认只回节索引（约 1KB，含每节字节数）；**不要 `--all` 读整篇**（5–14KB，读一次就留在后续每一轮窗口）。**带着具体问题（错误码/跨能力语义/某个词）直接 `omc help --search "<词>"`**——跨全部 topic 全文检索，命中节的正文随结果内联返回，一次调用就是答案；**严禁自己写 `for t in …; do omc help $t --all | grep …` 循环**（r18 实测 12 调用/176KB，检索一次 8KB 搞定）。
 2. 写前只需读 `omc-config-draft-review`（人审门）与 `omc-five-piece-flow`（发现→草稿→权限→执行→回读）；`omc-business-configuration` 按命中的能力分节读（见 `next` 的 `readSections`），不要整篇预取。
 3. 环境名以 `omc doctor` 的「环境=」或 `.omc-env` 为准；工具不确定先用默认 `describe`/`--example`，只有单个工具缺形状才用 `--full`；`describe` 带 `exampleHint`/`recipeHint` 时优先 `--example`。
 4. 只有工具不在 `next` 命中能力内、或要看 purpose/枚举时，才补一次 `commands --json --compact --lane <lane>`。非显然形状（规则图、流程模板、表单布局、RESTFUL）才单独 `describe --example`。
@@ -50,6 +50,7 @@ omc script - --env <env> <<< '{"tool":"model.list"}'   # 多调链：NDJSON 每
 omc capability <selected-id>               # only the selected capability
 omc describe <tool> --example <recipe-id>   # recipe first; default describe otherwise
 omc help <topic> --section "<heading>"       # one methodology section, not all
+omc help --search "40000"                    # full-text search across all topics (answer in one call)
 ```
 
 Discovery precedes every write. 预算档位见 `omc-tool-selection` 的「Discovery 成本档位」；裸 `omc commands` 是有界索引，全量目录须显式 `commands --json`。

package/skills/omc-tool-selection.md

@@ -85,7 +85,7 @@ Writes:
 1. Default to the high layer; drop to atoms only to compose what the orchestration doesn't cover.
 2. Preview any write with `dryRun:true`; it returns the plan and executes nothing.
 3. `writable:false` refuses before any wire. A production write additionally requires `confirmProduction:true`.
-4. Out-of-coverage desire (permissions, nested child tables, OCR, app publish)? The refusal cites the manifest entry — that is the answer. Check `coverage.manifest`.
+4. Out-of-coverage desire (permissions, cross-model child linkage, OCR, app publish)? The refusal cites the manifest entry — that is the answer. Check `coverage.manifest`. Note: nested child tables are not a coverage gap — the platform itself only supports one level of child table.
 5. If any call returns `uncertain`, stop writing and re-run discovery before the next write.
 
 ## Key-name table (同一对象在不同工具里的键名)

package/skills/omc-write-hazards.md

@@ -20,6 +20,9 @@ omc help omc-write-hazards
 - 调用方显式传 `draftAttributesJson`/`draftViewJson` 时，CLI 会在写前拒绝字符串 options、非字符串 viewJson 单元、子列混入 viewJson。
 - `form.draft rebuild:true` 会重建布局，但会保留已存在的非结构性控件 options；Sheet201 columns 以最新 subSchema 为准。
 - 空布局 `[]`/`{}` 默认拒绝；只有显式 `allowEmptyLayout:true` 才能清空。
+- **列数由 viewJson 行分组决定，不是 span**（2026-10-27 r24 真机实证）：`viewJson` 是行的数组，一行内 N 个 code 即 N 列；`span` 只是 24 栅格下的控件宽度。只把字段 `span` 改 8 而不动行分组 → 控件变窄但每行仍两个，不是三列。改列数必须同时改行分组（三列=每行 3 个 code，字段 span=8）→ `form.publish` → `form.get` 回读 viewJson 核对。系统字段行与业务字段行分开调整。
+- **模型不支持跨应用迁移**（1.1.25 真机实证：`folder-other-application` 拒绝）：模型建错应用时走「新应用重建 + 关联引用改指 + 旧模型删除」，不存在物理迁移命令。
+- **流程编排器是线性的，无并行会签**（1.1.25 实证）：多部门会签只能建成顺序节点链；需求里的「并行会签」按顺序节点落地并在交付说明里披露。
 
 ## 模型字段与关联
 
@@ -78,6 +81,8 @@ omc help omc-write-hazards
 ## 子表
 
 - 一个主表可以有多个 `CHILD_TABLE`，子表不能嵌套 `CHILD_TABLE`。
+- **子表控件（type 201）的显示/只读条件（displayFormula/readonlyFormula）不在字段面**：`field.update` 对子表父控件必拒（只管子表**列**）。可行路径是表单 attributes：`form.get --controls` 读 `draftAttributesJson` 定位控件 → `form.draft` 改该控件条件 → `form.publish`（`omc next "子表控件显示条件"` 已路由到该链）。
+- **直调 `runtime/form/save` 更新既有记录时主键放 `data.id`**：`bizObject.bizObjectId` 不被保存逻辑识别——接口仍回 `errcode:0` 但 `objectId` 是**新 id**（静默新增孤儿数据，券商 issue 2026-10-27 实证 2 条）。用 `omc call data.update` 则无此坑（`bizObjectId` 在顶层参数位）。
 - 子列是子表字段 code 对应 schema 上的普通字段：
 
 ```bash