@stalfh233/omc-cli 0.4.67 → 0.4.69

package/dist/cli-output.js

@@ -1,6 +1,6 @@
 import { writeFileSync } from "node:fs";
 import { asciiStdout, serializeEnvelope } from "./cli-contract.js";
-import { recordUsageOutput } from "./usage-log.js";
+import { currentUsageCommand, priorRepeatedFailures, recordUsageOutput } from "./usage-log.js";
 let options = { quiet: false, verbose: false };
 /** Parse `--quiet`, `--verbose` and `--out <file>` from the raw argv once, before dispatch. */
 export function configureOutput(argv) {
@@ -85,8 +85,38 @@ function emitAsciiBannerOnce() {
     // 横幅走 stderr（不进管道、不破坏单信封契约），在痛点时刻给出两个解法。
     process.stderr.write("[omc] 当前控制台代码页非 UTF-8，中文已 ASCII 转义防乱码。要原样中文：本次调用加 --utf8，或 chcp 65001 后重跑，或设 OMC_ASCII_STDOUT=0。\n");
 }
+/**
+ * Attach a repeat warning to a refusal that repeats the previous one. Refusal
+ * envelopes already say what is wrong; a third identical failure means the
+ * caller is tuning arguments inside a dead end (r6-onboarding 2026-10-21: 16
+ * repeat runs, 27 avoidable calls), so say so where it will be read.
+ */
+function withRepeatWarning(value) {
+    if (!value || typeof value !== "object")
+        return value;
+    const envelope = value;
+    const status = String(envelope.status ?? "");
+    if (status !== "refused" && status !== "error" && status !== "uncertain")
+        return value;
+    const result = envelope.result && typeof envelope.result === "object" ? envelope.result : undefined;
+    const blocker = typeof result?.blocker === "string" ? result.blocker : typeof envelope.blocker === "string" ? envelope.blocker : undefined;
+    const prior = priorRepeatedFailures(currentUsageCommand(), blocker);
+    if (prior.count < 2)
+        return value;
+    const repeatWarning = {
+        sameFailureCount: prior.count + 1,
+        blocker: blocker ?? null,
+        ...(prior.requestIds.length > 0 ? { previousRequestIds: prior.requestIds } : {}),
+        hint: status === "uncertain"
+            ? `同一调用已连续返回 uncertain ${prior.count + 1} 次。uncertain 表示结果未确定：先按 requestId 回读真实状态再决定，不要盲目重发写请求。`
+            : `同一调用已连续失败 ${prior.count + 1} 次（blocker ${blocker ?? "unknown"}）。不要再微调参数重试：换形状或换工具——先 describe/配方确认契约，或按 blocker 指向的替代路径处理。`,
+    };
+    if (result)
+        return { ...envelope, result: { ...result, repeatWarning } };
+    return { ...envelope, repeatWarning };
+}
 export function writeEnvelope(value) {
-    const outputValue = compactForOutput(value);
+    const outputValue = compactForOutput(withRepeatWarning(value));
     const text = serializeEnvelope(outputValue);
     if (asciiStdout())
         emitAsciiBannerOnce();

package/dist/lanes/runtime-data.js

@@ -1048,22 +1048,14 @@ export function registerRuntimeDataLane(tools) {
             draftObjectId = targetObjectId;
         }
         else if (formType === "2") {
-            const saved = await runtimeWriteWithAppMapping(session, args.schemaCode, 50000, "data.submit 运行时提交稳定失败（50000）", () => wireCall(session, {
-                path: ENDPOINTS.runtimeFormSave,
-                method: "POST",
-                body: { bizObject: { schemaCode: args.schemaCode, sheetCode, data: formData } },
-            }));
-            const savedData = (saved.data ?? {});
-            draftObjectId = typeof savedData.bizObjectId === "string" ? savedData.bizObjectId : typeof savedData.objectId === "string" ? savedData.objectId : null;
-            if (!draftObjectId)
-                throw new WireError("business", "submit chain: draft save returned no bizObjectId", 304001);
-            // No post-save form/load (ticket 18): the submit persists
-            // bizObject.data itself and updateBizObject merges patch-style onto
-            // the stored row, and initSubmitBizObject.setOwner re-reads the
-            // stored row's owner server-side — so formData + the saved id is the
-            // complete submit payload.
+            // Live 1.1.25 (r7-vehicle 2026-10-21): the previous chain did
+            // form/save (creating a DRAFT row) and then submitted with that id —
+            // the platform INSERTED A SECOND ROW instead of completing the first,
+            // leaving one COMPLETED + one orphan DRAFT per submit (verified in
+            // ia38g_veh_vehicle: same plateNo, same second, statuses COMPLETED and
+            // DRAFT). form/submit persists bizObject.data itself (ticket 18), so
+            // skip the pre-save and let the platform create+complete in one call.
             payload.bizObject = {
-                id: draftObjectId,
                 schemaCode: args.schemaCode,
                 sheetCode,
                 data: stripEngineOwnedKeys(formData),

package/dist/lanes/workflow.js

@@ -2226,10 +2226,18 @@ export function registerWorkflowLane(tools) {
                     schemaCode: linked?.schemaCode ?? wireString(item.schemaCode),
                 };
             });
+            // r6-onboarding 2026-10-21: 89 of 117 calls used this tool with only a
+            // schemaCode — mostly to ask "where did the flow go", which the todo query
+            // cannot answer (it lists pending items only). Say what this call is for
+            // at the moment it is used, and name the two substitutes.
+            const purposeHint = args.workflowInstanceId === undefined && args.workflowCode === undefined
+                ? "本调用用于发现待办并取 workItemId 做审批；只想看流程走到哪，用 workflow.instanceActivity；提交/审批后优先复用 data.submit 的 readback.nextSubmit，不要重复查询。"
+                : undefined;
             return {
                 total: page.total,
                 totalPages: page.totalPages,
                 count: items.length,
+                ...(purposeHint ? { purposeHint } : {}),
                 ...(page.unfilteredTotal !== undefined ? { unfilteredTotal: page.unfilteredTotal } : {}),
                 items,
             };

package/dist/recipes/businessrule.js

@@ -77,7 +77,7 @@ const ruleBranchGraph = Object.freeze({
     conditionalRequirements: [
         "**系统节点顺序：BRANCH 必须排在 `SYSTEM_CREATE` 之后**——BRANCH 直接接在 START 后会运行时静默不生效、动作不回写（工具 fail closed）。注意这与 BIZ_ACTION 回写场景相反（那里系统节点要在动作之后）——本 recipe 是分支场景。**`SYSTEM_CREATE` 必须显式写**（工具对分支图的自动注入不可靠）。",
         "**出口条件叶只 4 个键** `{currentSchemaDataItem(左值字段),ruleDataConditionType(操作符),ruleValueType,value}`；用 UI 键 `targetSchemaDataItem`+`ruleConditionType` 会 save+publish 过但运行时 50000（工具 fail closed `rule-graph-branch-condition-keys`）。",
-        "**下列键可省、工具自动补**（省 token；真机验证极简图 1170B vs 全显式 1690B，−31%）：每个节点的 `nodeName`；BRANCH 的 `inputParam:\"_input\"`/`judgeMethod:\"DEFAULT\"`；自更新 UPDATE（`targetObjectCode`=本模型）的 `inputParam:\"_input\"`/`filterCondition`（身份匹配）；非兜底路由的 `routeCondition:true`/`matchType`。仅 BRANCH 的 `sourceInputMethod` 与兜底 else 的 `routeCondition:false` 需显式。**跨模型写（UPDATE/CREATE/DELETE 的 `targetObjectCode`≠规则模型）运行时未验证：lint 给非阻断 warning `rule-graph-cross-model-unverified`（2026-09-27 真机 data.submit 探测只有同模型 UPDATE 生效），交付前必须实测；稳妥用同模型回写或 BIZ_ACTION/二开。**",
+        "**下列键可省、工具自动补**（省 token；真机验证极简图 1170B vs 全显式 1690B，−31%）：每个节点的 `nodeName`；BRANCH 的 `inputParam:\"_input\"`/`judgeMethod:\"DEFAULT\"`；自更新 UPDATE（`targetObjectCode`=本模型）的 `inputParam:\"_input\"`/`filterCondition`（身份匹配）；非兜底路由的 `routeCondition:true`/`matchType`。仅 BRANCH 的 `sourceInputMethod` 与兜底 else 的 `routeCondition:false` 需显式。**跨模型写（`targetObjectCode`≠规则模型）已真机验证可用**（1.1.25，2026-10-21：FIXED id / 文本字段 / 单跳关联字段三种 DYNAMIC 来源均命中）——前提是 ① 承载规则真的触发（Create 在提交时、Update 在 data.update、或绑流程事件）；② **目标行必须已提交（COMPLETED）**，DRAFT 行不参与查询（日志「查找范围不存在数据」）。点号路径按子表解析：`关联字段.id` 与两跳 `a.b` 不可用。",
         "预置规则的系统节点类型必须与 ruleCode 匹配（Create→SYSTEM_CREATE）；放 SYSTEM_UPDATE 会 data.submit 50000（工具 fail closed）。",
     ],
     priorToolReferences: [

package/dist/usage-log.js

@@ -1,4 +1,4 @@
-import { appendFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
+import { appendFileSync, existsSync, mkdirSync, openSync, readFileSync, readSync, closeSync, statSync } from "node:fs";
 import { createHash } from "node:crypto";
 import { dirname, resolve } from "node:path";
 let pending;
@@ -9,6 +9,47 @@ function logPath() {
     const projectEnv = resolve(process.cwd(), ".omc-env");
     return existsSync(projectEnv) ? resolve(process.cwd(), ".omc", "usage.jsonl") : undefined;
 }
+/** The command string of the in-flight invocation (for diagnostics). */
+export function currentUsageCommand() {
+    return pending?.command;
+}
+/**
+ * How many consecutive PRIOR invocations failed the same way. A refusal tells
+ * the caller what is wrong; three identical refusals in a row mean the caller is
+ * tuning arguments inside a dead end instead of changing approach (r6-onboarding
+ * 2026-10-21: 16 such runs, 43 calls, 27 of them avoidable).
+ */
+export function priorRepeatedFailures(command, blocker, limit = 40) {
+    if (!command)
+        return { count: 0, requestIds: [] };
+    const path = logPath();
+    if (!path)
+        return { count: 0, requestIds: [] };
+    // Read only the tail: this runs on every refusal, and the log grows with the
+    // session (r6: 1528 records). Parsing the last ~64 KB is enough for `limit`.
+    const tail = readUsageTail(path, 65536).slice(-limit);
+    const matches = (record) => {
+        if (String(record.command ?? "") !== command)
+            return false;
+        const status = String(record.status ?? "");
+        if (status === "ok" || status === "dry-run" || status === "no-envelope")
+            return false;
+        if (blocker === undefined)
+            return true;
+        return String(record.blocker ?? "") === blocker;
+    };
+    let count = 0;
+    const requestIds = [];
+    for (let index = tail.length - 1; index >= 0; index -= 1) {
+        if (!matches(tail[index]))
+            break;
+        count += 1;
+        const requestId = tail[index].requestId;
+        if (typeof requestId === "string" && requestIds.length < 3)
+            requestIds.push(requestId);
+    }
+    return { count, requestIds };
+}
 function commandOf(argv) {
     const values = [];
     for (let index = 2; index < argv.length && values.length < 2; index += 1) {
@@ -91,6 +132,12 @@ export function recordUsageOutput(value, stdoutBytes, fileBytes = 0) {
     pending.status = String(envelope.status ?? "unknown");
     if (typeof error?.code === "string")
         pending.errorCode = error.code;
+    // The blocker is the actionable half of a refusal (policy-refused alone says
+    // nothing); record it so repeat detection and accounting can group by cause.
+    const resultEnvelope = envelope.result && typeof envelope.result === "object" ? envelope.result : undefined;
+    const blocker = typeof resultEnvelope?.blocker === "string" ? resultEnvelope.blocker : typeof envelope.blocker === "string" ? envelope.blocker : undefined;
+    if (blocker)
+        pending.blocker = blocker;
     // 0.4.16：requestId 落盘（信封瘦身把它从 stdout 移除后，排障关联的唯一落点）
     if (typeof envelope.requestId === "string")
         pending.requestId = envelope.requestId;
@@ -118,10 +165,37 @@ export function completeUsage(exitCode) {
         status: current.status,
         exitCode,
         ...(current.errorCode ? { errorCode: current.errorCode } : {}),
+        ...(current.blocker ? { blocker: current.blocker } : {}),
         ...(current.requestId ? { requestId: current.requestId } : {}),
     };
     appendFileSync(path, `${JSON.stringify(record)}\n`, "utf8");
 }
+function readUsageTail(path, maxBytes) {
+    if (!existsSync(path))
+        return [];
+    const size = statSync(path).size;
+    const start = Math.max(0, size - maxBytes);
+    const fd = openSync(path, "r");
+    try {
+        const buffer = Buffer.alloc(size - start);
+        readSync(fd, buffer, 0, buffer.length, start);
+        const text = buffer.toString("utf8");
+        // Drop a leading partial line when the tail started mid-record.
+        const body = start > 0 ? text.slice(text.indexOf("\n") + 1) : text;
+        return body.split(/\r?\n/).filter(Boolean).flatMap((line) => {
+            try {
+                const value = JSON.parse(line);
+                return value && typeof value === "object" ? [value] : [];
+            }
+            catch {
+                return [];
+            }
+        });
+    }
+    finally {
+        closeSync(fd);
+    }
+}
 function readUsage(path) {
     if (!existsSync(path))
         return [];

package/package.json

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