@stalfh233/omc-cli 0.4.67 → 0.4.68

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/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/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.68",
   "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.68",
     "commander": "14.0.3",
-    "omc-core": "0.4.67",
+    "omc-core": "0.4.68",
     "proper-lockfile": "4.1.2",
     "write-file-atomic": "6.0.0",
     "zod": "^3.23.8",