@stalfh233/omc-cli 0.6.10 → 0.6.12

package/dist/cli-contract.js

@@ -46,7 +46,28 @@ export function asciiStdout() {
     // ever answer "not a Windows code page here".
     if (process.platform !== "win32")
         return false;
-    return asciiStdoutFor(process.platform, process.stdout.isTTY === true, activeCodePage());
+    return asciiStdoutFor(process.platform, process.stdout.isTTY === true, activeCodePage(), process.env);
+}
+/**
+ * Hosts that are known to decode UTF-8 from a pipe regardless of the console
+ * code page. Escaping inside them is **pure loss**: the reader is a UTF-8
+ * consumer (Windows Terminal, VS Code, an agent harness), so `\u6295\u5f71`
+ * reads as garbage to the human skimming the transcript while the JSON was
+ * parseable either way.
+ *
+ * 2026-11-05 用户实测（Windows + agent harness）：整屏 `\uXXXX`，人眼无法阅读。
+ * 之前只判「TTY 与否 + 代码页」，把「现代终端里被 harness 捕获」也当成了旧管道。
+ */
+export function utf8CapableHost(env) {
+    // Windows Terminal 与任何设置了 TERM_PROGRAM 的宿主（VS Code / WezTerm / …）。
+    if (typeof env.WT_SESSION === "string" && env.WT_SESSION !== "")
+        return true;
+    if (typeof env.TERM_PROGRAM === "string" && env.TERM_PROGRAM !== "")
+        return true;
+    // 与上面同理：显式声明了 TERM 的现代终端/PTY。
+    if (typeof env.TERM === "string" && env.TERM !== "" && env.TERM !== "dumb")
+        return true;
+    return false;
 }
 /**
  * T2（GitLab #17，2026-11-04）：`--utf8` 是「人类可读文本按 UTF-8 原文输出」的
@@ -110,11 +131,14 @@ function activeCodePage() {
     return cachedCodePage;
 }
 /** Pure core of asciiStdout for tests: platform × tty × active code page. */
-export function asciiStdoutFor(platform, isTty, codePage) {
+export function asciiStdoutFor(platform, isTty, codePage, env = {}) {
     if (platform !== "win32")
         return false;
     if (isTty)
         return false;
+    // 已知 UTF-8 宿主：代码页是旧的不代表**消费者**解不了 UTF-8（harness / 现代终端）。
+    if (utf8CapableHost(env))
+        return false;
     // Unknown code page (chcp unavailable — modern terminal hosts): trust
     // UTF-8. Windows Terminal defaults to it, and \u escapes are unreadable to
     // humans either way.

package/dist/cli-output.js

@@ -132,8 +132,12 @@ function emitAsciiBannerOnce() {
     // 注意：ascii 模式下 stderr 本身也会被转义，所以横幅必须是纯 ASCII。
     if (process.env.OMC_ASCII_STDOUT !== undefined || process.env.OMC_HUMAN_UTF8 !== undefined)
         return;
-    process.stderr.write("[omc] non-UTF-8 console code page: the JSON envelope is \\u-escaped so it stays parseable. "
-        + "Human text: `chcp 65001`, or add --utf8 (stderr only; the envelope stays escaped by design).\n");
+    // 2026-11-05：旧横幅只给了 `--utf8`，而它**只管 stderr**——用户要的正是不想再
+    // 看 `\uXXXX`，照它做没有效果。给出真正能关掉转义的两个办法。
+    process.stderr.write("[omc] legacy console code page detected: the JSON envelope is \\u-escaped (e.g. \\u6295\\u5f71) so it stays parseable.\n"
+        + "      If your consumer decodes UTF-8 (agent harness / VS Code / Windows Terminal), turn it off:\n"
+        + "        set OMC_ASCII_STDOUT=0        (Windows cmd / PowerShell: $env:OMC_ASCII_STDOUT=0)\n"
+        + "      or switch the console itself: chcp 65001\n");
 }
 /**
  * Attach a repeat warning to a refusal that repeats the previous one. Refusal

package/dist/cli.js

@@ -1027,11 +1027,31 @@ async function cmdBench(args) {
     const liveSample = args.includes("--live-sample");
     const envIndex = args.indexOf("--env");
     const liveEnvironment = envIndex >= 0 ? args[envIndex + 1] : undefined;
-    const { runBench, formatBenchReport } = await import("./bench/run.js");
+    // 2026-11-05（安装事故）：`@stalfh233/omc-fake-platform` 是**评测基座**，只有
+    // `omc bench` 用得到；它此前是硬依赖，导致「这一个包在某人缓存里还没同步」
+    // 就把整次 `npm i -g omc-cli` 卡死（ETARGET）。现在它降为 optionalDependencies
+    // （装不上不阻塞安装），bench 在缺失时给可执行的补救指引而不是抛堆栈。
+    let runBenchImport;
+    try {
+        const mod = await import("./bench/run.js");
+        runBenchImport = async () => mod;
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ERR_MODULE_NOT_FOUND" && String(error.message).includes("omc-fake-platform")) {
+            console.error("omc bench 需要评测基座 @stalfh233/omc-fake-platform（**可选依赖**，不装 CLI 也能正常用）。\n" +
+                "补齐：npm i -D @stalfh233/omc-fake-platform@<与 omc-cli 同版本>\n" +
+                "（它只是本地假平台/假 HTTP 服务器，仅 bench 与测试使用，配置 CloudPivot 完全不需要。）");
+            return 10;
+        }
+        throw error;
+    }
+    const { runBench, formatBenchReport } = await runBenchImport();
     const report = await runBench({ mode: liveSample ? "live-sample" : "fake", ...(liveEnvironment ? { liveEnvironment } : {}) });
     console.error(formatBenchReport(report));
     const failedSteps = report.steps.filter((step) => !step.ok).length;
-    return failedSteps === 0 && report.dimensions.intent.passed === report.dimensions.intent.cases ? 0 : 1;
+    const dims = report.dimensions;
+    return failedSteps === 0 && dims.intent.passed === dims.intent.cases ? 0 : 1;
 }
 function cmdDiscovery(kind, transport, value, options = {}) {
     const registry = buildToolRegistry();
@@ -2172,7 +2192,9 @@ async function main() {
         commandExitCode = await withTransport(options, request, (transport) => cmdDiscovery("describe", transport, tool, { full: options.full === true, schemaOnly: options.schemaOnly === true, ...(options.param ? { param: options.param } : {}), ...(options.example ? { example: options.example } : {}) }));
     });
     command.command("contract <lane>").option("--full").option("--tool <name>").option("--max-output-bytes <bytes>").action(async (lane, options) => { commandExitCode = await withTransport(options, request, (transport) => cmdDiscovery("contract", transport, lane, { full: options.full === true, ...(options.tool ? { tool: options.tool } : {}) })); });
-    command.command("capabilities").option("--compact").option("--max-output-bytes <bytes>").action(async (options) => { commandExitCode = await withTransport(options, request, (transport) => cmdCapabilities(transport, options.compact === true)); });
+    // 2026-11-05 用户实测：`commands --json` 存在，于是大家自然写 `capabilities --json`
+    // ——旧实现报 `unknown option`（退出码 10）。输出本来就是 JSON 信封，接受它做兼容别名。
+    command.command("capabilities").option("--compact").option("--json", "兼容别名：输出本就是 JSON 信封（与 commands --json 对齐）").option("--max-output-bytes <bytes>").action(async (options) => { commandExitCode = await withTransport(options, request, (transport) => cmdCapabilities(transport, options.compact === true)); });
     // `--env` is accepted but ignored: `next` is a zero-environment-contact route
     // solver, and a caller who reflexively passes `--env` should not be refused
     // (round 15 dogfood: `next "<goal>" --env local` → unknown option, one round).

package/dist/path-projection.js

@@ -220,6 +220,24 @@ export function pathMissEntryHint(at, available) {
  * available 不是字符串数组（范围说明 / 空对象文案）或匹配不到时不加字段——
  * 误导建议比没有更糟；过短输入由 closestMatch 自己静默。
  */
+/**
+ * 读面里「人人都会猜错一次」的键名（2026-11-05 用户 Windows 实测）：
+ * `app.list` 回的是 `applications`，但 `--jq .apps[]` 是所有人的第一反应，
+ * 而 closestMatch（编辑距离）判不了 app→application 这种**语义改名**，于是
+ * pathMiss 只给键列表，用户要再猜一轮。这里补一张极小的已知别名表。
+ * 只放**已证实的高频误写**，不要变成第二套命名。
+ */
+const PATH_KEY_ALIASES = Object.freeze({
+    apps: "applications",
+    application: "applications",
+    app: "applications",
+    models: "items",
+    rows: "items",
+    list: "items",
+    content: "publishedContent",
+    data: "fields",
+    props: "properties",
+});
 export function pathMissDidYouMean(at, available) {
     if (at === undefined || at.length === 0)
         return undefined;
@@ -233,7 +251,12 @@ export function pathMissDidYouMean(at, available) {
     const leaf = at.includes(".") || at.includes("/") || at.includes("[")
         ? at.replace(/^[.\/]+/, "").split(/[./\[]/).filter(Boolean).pop() ?? at
         : at;
-    return closestMatch(leaf, keys);
+    const closest = closestMatch(leaf, keys);
+    if (closest !== undefined)
+        return closest;
+    // 语义改名（apps→applications 这类编辑距离判不出的），只在该键**确实存在**时建议。
+    const alias = PATH_KEY_ALIASES[leaf.toLowerCase()];
+    return alias !== undefined && keys.includes(alias) ? alias : undefined;
 }
 /**
  * 多路径一次投影时的**唯一一份**语法说明（放结果顶层，不再逐条复制）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stalfh233/omc-cli",
-  "version": "0.6.10",
+  "version": "0.6.12",
   "description": "CloudPivot 8.6 configuration capability CLI — governed, fail-closed, coverage-manifest bounded.",
   "type": "module",
   "bin": {
@@ -54,9 +54,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@stalfh233/omc-fake-platform": "0.6.10",
     "commander": "14.0.3",
-    "omc-core": "0.6.9",
+    "omc-core": "0.6.12",
     "proper-lockfile": "4.1.2",
     "write-file-atomic": "6.0.0",
     "zod": "^3.23.8",
@@ -72,5 +71,8 @@
     "type": "git",
     "url": "https://gitlab.h3yun.com/fuwenbin/oh-my-cpagents.git",
     "directory": "packages/omc-cli"
+  },
+  "optionalDependencies": {
+    "@stalfh233/omc-fake-platform": "0.6.12"
   }
 }