@stalfh233/omc-cli 0.4.32 → 0.4.34

package/dist/execution-metadata.js

@@ -1050,6 +1050,27 @@ const dataListFilter = Object.freeze({
     refusalRecovery: [{ code: "invalid-filter-DSL", action: "按错误里的 minimalValidFilter/acceptedOps 修正 op/field/value" }],
     requiresEnvironmentDerivedIds: false,
 });
+const dataDeleteSweep = Object.freeze({
+    id: "sweep-all-readback",
+    title: "清空模型数据并权威验证（list 取 ids → delete → 复验 total:0）",
+    status: "offline-valid",
+    tool: "data.delete",
+    args: { environment, schemaCode: model, bizObjectIds: ["<data.list 逐条 id>"] },
+    preconditions: [
+        "先 data.list 取全量 ids（page 0 起、size 够大或翻页）；**submit 后平台会同时保留 DRAFT 与 COMPLETED 两类行（r30 实证 5 次提交 = 10 行），清理对象按 data.list 全量**",
+    ],
+    conditionalRequirements: [
+        "参数名是 `bizObjectIds`（数组）——不是 ids/bizObjectId（单条删除另有其参）",
+        "id 已被删时幂等 no-op，重复清理安全",
+    ],
+    priorToolReferences: [
+        { tool: "data.list", args: { environment, schemaCode: model }, purpose: "取全量 bizObjectIds（含 DRAFT 行）" },
+    ],
+    dryRun: { supported: true, command: `omc call data.delete --env ${environment} --dry-run --args '<recipe.args>'`, notes: "dry-run 出删除计划不落库" },
+    expectedReadback: { readback: { deleted: "N", modelResidue: { total: 0 } }, next: ["data.list 复验 total:0 / items:[]（权威清空判据）"] },
+    refusalRecovery: [{ code: "wire-business", action: "模型须已创建且有已发布字段；运行面 50000 时先 model.inspect modelPresent 判存在" }],
+    requiresEnvironmentDerivedIds: false,
+});
 const dictionaryKeyValue = Object.freeze({
     id: "dictionary-key-value",
     title: "建一个键值字典并用其 id 作字段下拉来源",
@@ -1103,6 +1124,7 @@ export const EXECUTION_METADATA = Object.freeze({
     "method.update": Object.freeze({ recipes: [bizserviceSelfCallCorp], relatedTools: ["method.get", "method.create", "service.get"] }),
     "listview.configure": Object.freeze({ recipes: [listViewConfigure], relatedTools: ["listview.list", "listview.get", "field.list", "field.publish"] }),
     "data.list": Object.freeze({ recipes: [dataListFilter], relatedTools: ["data.load", "data.delete", "listview.configure", "field.list"] }),
+    "data.delete": Object.freeze({ recipes: [dataDeleteSweep], relatedTools: ["data.list", "data.load", "data.submit"] }),
 });
 export function executionMetadataFor(tool) {
     return EXECUTION_METADATA[tool.name];

package/dist/intent/schema.js

@@ -35,6 +35,7 @@ export const RUNNABLE_EXAMPLES = Object.freeze([
             "      - { code: orderNo, name: 订单号, type: SHORT_TEXT }",
             "      - { code: amount, name: 金额, type: NUMERICAL, options: { scale: 2 } }",
             "      - { code: level, name: 等级, type: RADIO, choices: [A, B, C] }  # choices 只用于 RADIO/CHECKBOX/DROPDOWN_BOX/DROPDOWN_MULTI_BOX",
+            "    # 字段 code 避开平台保留字（id/name/owner/creater/createdTime/modifiedTime/version/…）——撞保留字 offline 校验即拒（code_reserved）；name 是字段中文名，不是 code（r31 实证 code:name 被拒后改 itemName 成功）",
             "    form: { publish: true }",
             "    listview: { fieldCodes: [orderNo, amount, level] }",
             "",

package/dist/lanes/model.js

@@ -171,7 +171,7 @@ export function registerModelLane(tools) {
             const codes = args.schemaCodes && args.schemaCodes.length > 0 ? args.schemaCodes : args.schemaCode ? [args.schemaCode] : [];
             if (codes.length === 0)
                 throw new ToolInputError({ status: "error", blocker: "tool-input-invalid", tool: "model.inspect", message: "需要 schemaCode（单个）或 schemaCodes（数组，批量）" });
-            const face = async (name, toolArgs) => {
+            const face = async (name, toolArgs, errcodes) => {
                 const tool = siblings.find((entry) => entry.name === name);
                 if (!tool)
                     return undefined;
@@ -184,17 +184,24 @@ export function registerModelLane(tools) {
                     const result = (await withoutReadbackCache(ctx, async () => (await tool.handler(ctx, parsed, tool))));
                     return result;
                 }
-                catch {
+                catch (error) {
+                    // r30: record the wire errcode so inspectOne can turn the field
+                    // face's 300004 into a `modelPresent:false` verdict instead of an
+                    // all-empty aggregate that reads as "registered, no fields".
+                    const errcode = error.errcode;
+                    if (errcodes && typeof errcode === "number")
+                        errcodes.set(name, errcode);
                     return undefined; // a single face being unreachable must not sink the whole inspect
                 }
             };
             const inspectOne = async (schemaCode) => {
+                const faceErrcodes = new Map();
                 // F5: the six read faces are INDEPENDENT wire reads; fan them out in
                 // parallel (bounded) instead of paying six sequential round-trips. Only
                 // workflow.get_published stays chained (it needs workflowCode from the
                 // draft face). Output ordering is unchanged (results land by index).
                 const [fieldFace, formFace, listviewFace, ruleFace, dataruleFace, draftFace] = await mapBounded([
-                    () => face("field.list", { schemaCode, published: true, ...(all ? { all: true } : {}) }),
+                    () => face("field.list", { schemaCode, published: true, ...(all ? { all: true } : {}) }, faceErrcodes),
                     () => face("form.get", { schemaCode }),
                     () => face("listview.get", { schemaCode }),
                     () => face("rule.list", { schemaCode }),
@@ -245,15 +252,29 @@ export function registerModelLane(tools) {
                         activities: Array.isArray(summary?.activities) ? summary.activities.map((activity) => ({ code: activity.code, type: activity.type, name: activity.name, participant: activity.participant })) : [],
                         edges: summary?.edges,
                     };
+                // r30 verdict: field face ok ⇒ model exists. The wire refusal for a
+                // missing model is a RETURNED payload (status:"refused", errcode:300004
+                // 数据模型不存在), not a throw — read both signals (returned refusal +
+                // thrown WireError) before deciding; unreachable face ⇒ undefined.
+                const fieldRefused = fieldFace !== undefined && fieldFace.status === "refused";
+                const fieldRefusalErrcode = fieldRefused ? Number(fieldFace.errcode) : undefined;
+                const absent = fieldRefusalErrcode === 300004 || faceErrcodes.get("field.list") === 300004;
+                const modelPresent = absent ? false : fieldFace !== undefined && !fieldRefused ? true : undefined;
                 return {
                     schemaCode,
+                    ...(modelPresent !== undefined ? { modelPresent } : {}),
+                    ...(modelPresent === false
+                        ? {
+                            existenceHint: "模型不存在（field.list 300004）——先 model.create / configure_model 再挂字段；勿把空聚合读成『已存在但无字段』（r30 实证该误读导致 field.create 300004 失败往返）",
+                        }
+                        : {}),
                     fields,
                     form,
                     listview,
                     rules,
                     datarules,
                     workflow,
-                    hint: "model.inspect 聚合设计时六面（fields/form/listview/rules/datarules/workflow，摘要）。字段 options 细节用 field.list --code；规则图用 rule.get schemaCode+ruleCode；运行数据用 data.list（不在此面）。",
+                    hint: "model.inspect 聚合设计时六面（fields/form/listview/rules/datarules/workflow，摘要）。modelPresent 是存在性判据（field 面 300004=false）；字段 options 细节用 field.list --code；规则图用 rule.get schemaCode+ruleCode；运行数据用 data.list（不在此面）。",
                 };
             };
             const one = await inspectOne(codes[0]);

package/dist/lanes/report.js

@@ -319,7 +319,9 @@ export function registerReportLane(tools) {
         };
     });
     writeTool(tools, "report.create", LANE, TOOLS["report.create"].scope, TOOLS["report.create"].description, {
-        code: z.string().min(1),
+        // r33: the platform refuses report codes longer than 28 chars (errcode
+        // 10005) — enforce offline so the shape never costs a wire round trip.
+        code: z.string().min(1).max(28).describe("报表 code；平台上限 28 字符（10005 实证 r33）——超长在提交前直接被拒"),
         name: z.string().min(1).max(60),
         appCode: z.string().min(1),
         parentId: z.string().min(1),

package/dist/lanes/runtime-data.js

@@ -434,6 +434,26 @@ export function registerRuntimeDataLane(tools) {
                     if (error instanceof WireError && error.kind === "business" && error.errcode === RUNTIME_DATA_WIRE.emptyModelErrcode) {
                         return { schemaCode: args.schemaCode, total: 0, totalPages: 0, page: args.page ?? 0, size: args.size ?? 10, items: [] };
                     }
+                    // r30: a MISSING model answers this face with a generic 50000
+                    // 服务异常 — indistinguishable from a real outage. One field-face
+                    // probe disambiguates: its 300004 (数据模型不存在) turns the
+                    // refusal into an existence verdict so the caller creates instead
+                    // of retrying; any other outcome rethrows the original 50000.
+                    if (error instanceof WireError && error.kind === "business" && error.errcode === 50000) {
+                        try {
+                            await wireCall(session, { path: ENDPOINTS.fieldList, query: { schemaCode: args.schemaCode, isPublish: "true" } });
+                        }
+                        catch (probeError) {
+                            if (probeError instanceof WireError && probeError.kind === "business" && probeError.errcode === 300004) {
+                                return {
+                                    status: "refused",
+                                    blocker: "wire-business",
+                                    errcode: 300004,
+                                    message: `数据模型不存在（${args.schemaCode}）——运行面读取前模型必须已创建并发布字段；先 model.create / configure_model（存在性判据用 model.inspect 的 modelPresent）`,
+                                };
+                            }
+                        }
+                    }
                     throw error;
                 }
                 const page = extractBizObjectPage(result.data);

package/dist/lanes/workflow.js

@@ -1657,7 +1657,10 @@ export function registerWorkflowLane(tools) {
                 .describe("exact-match client-side filter on the returned items' instanceId (the server filterWorkflowInstanceId field is a NOT-equal exclusion, so it is not used)"),
             workflowCode: z.string().optional(),
             schemaCode: z.string().optional(),
-            page: z.number().int().min(0).optional(),
+            // r35: an agent sent page:1 expecting the first page and read
+            // `total:1 / count:0` as a contradiction — the page index is ZERO-based
+            // (like data.list). Say so at the parameter itself.
+            page: z.number().int().min(0).optional().describe("页号，0 基（与 data.list 一致）；默认 0"),
             size: z
                 .number()
                 .int()

package/package.json

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

package/skills/omc-start-here.md

@@ -23,7 +23,7 @@ be treated as a second source. Read this, then follow the topics it names.
 3. 环境名以 `omc doctor` 的「环境=」或 `.omc-env` 为准；工具不确定先用默认 `describe`/`--example`，只有单个工具缺形状才用 `--full`；`describe` 带 `exampleHint`/`recipeHint` 时优先 `--example`。
 4. 只有工具不在 `next` 命中能力内、或要看 purpose/枚举时，才补一次 `commands --json --compact --lane <lane>`。非显然形状（规则图、流程模板、表单布局、RESTFUL）才单独 `describe --example`。
 5. 键名按对象不同：模型 `schemaCode`、默认表单 `sheetCode`（可省略，默认 == 模型 code）、流程 `workflowCode`/`code`——报错会提示同义键；字段族名认不出会给「最接近的族」。
-6. **写操作串行**：同一环境不要并发写；`write-lock-held` 是瞬态，等几秒重试一次即可。
+6. **写操作串行**：同一环境不要并发写（含多个 `omc call` 并行进程——环境写锁互斥，r31 实证并行 field.create 2/3 被拒）；多个写合并为一条 `omc script` 逐行跑（进程内自动串行）；`write-lock-held` 是瞬态，等几秒重试一次即可。
 7. **单个对象优先高阶编排工具**：模型+字段用 `configure_model`（一次含全部字段），表单用 `configure_form`，列表用 `listview.configure`（**默认视图已存在，省略 code 即配置它，不要 `listview.create`**）。原子工具留给单点修改。
 8. 拿到 `detailArtifactId` 先 `artifact get <id> --summary` 看结构，再 `--keys/--jq` 取所需；`field.list`/`workflow.*` 默认面已给清单与节点摘要；`workflow.get_draft` 默认面已含 `edges`，改流程只需传 `activities`+`routes`。
 9. 每个 section 读一次即可；同一 topic 不要反复读。