@stalfh233/omc-cli 0.4.12 → 0.4.14

package/README.md

@@ -246,12 +246,12 @@ src/        args/support/plan/read/write/package/context（治理管道）
 
 ## npm 分发
 
-本包（`@stalfh233/omc-cli`，可执行命令仍是 `omc`）通过公共 npm registry 分发。`omc-core` 是 `omc-cli` 的内部依赖，发布时先发 `omc-core`，再发 `omc-cli`；两者版本保持一致。当前版本为 `0.4.12`，尚未宣称 `1.0.0` 稳定契约。
+本包（`@stalfh233/omc-cli`，可执行命令仍是 `omc`）通过公共 npm registry 分发。`omc-core` 是 `omc-cli` 的内部依赖，发布时先发 `omc-core`，再发 `omc-cli`；两者版本保持一致。当前版本为 `0.4.14`，尚未宣称 `1.0.0` 稳定契约。
 
 ### 使用已发布包
 
 ```bash
-npm install -g @stalfh233/omc-cli@0.4.12
+npm install -g @stalfh233/omc-cli@0.4.14
 omc setup
 omc doctor
 omc help omc-write-hazards
@@ -270,6 +270,10 @@ npm publish --workspace packages/omc-cli
 
 `omc-core` 与 `omc-cli` 版本保持一致；发布前先用 `git tag vX.Y.Z` 记录该版本。新包首次发布进入 npm staged-publishing 审核队列，需维护者在 npmjs.com 用交互式 2FA 批准后真实版本才可见。
 
+### 输出编码
+
+stdout 是机器解析的 JSON，编码按消费方选择：**终端**（`isTTY`）写原始 UTF-8（Windows 上 Node 走 `WriteConsoleW`，中文正常显示）；**管道/重定向/捕获**写 ASCII 安全 JSON（非 ASCII 转义成 `\uXXXX`，任何代码页都能正确解析，等价于 Python `json.dumps(ensure_ascii=True)`）。Linux/macOS 始终原始 UTF-8；`--out` 文件、artifact、stderr、CloudPivot 请求体始终原始 UTF-8。强制用 `OMC_ASCII_STDOUT=1|0`。
+
 ### 版本策略
 
 - `0.2.x`：继续演进 CLI/覆盖清单/配置契约，允许新增能力和必要的行为修复。

package/dist/cli-contract.js

@@ -13,16 +13,39 @@ export function envelope(status, result, requestId, error = null) {
 /**
  * The single stdout serialization for every envelope.
  *
- * stdout is always UTF-8, on every platform. Escaping non-ASCII to `\uXXXX`
- * (an earlier win32 "ASCII-safe" mode) is deliberately gone: it made Windows
- * output diverge from POSIX byte-for-byte, broke plain string matching
- * (`findstr 采购`), and only worked around a legacy console code page that a
- * modern terminal (Windows Terminal, PowerShell 7, `chcp 65001`) fixes by
- * itself. JSON is UTF-8 by spec; downstream tools parse it losslessly. Callers
- * that truly need a file use `--out`, which was always raw UTF-8.
+ * Encoding is chosen by the CONSUMER, because "correct" differs by context:
+ *
+ * - A real terminal (stdout.isTTY) renders UTF-8 correctly on Windows: Node
+ *   writes UTF-16 through the console API (WriteConsoleW), which bypasses the
+ *   console code page entirely. So there we emit raw UTF-8 and a human sees
+ *   readable Chinese.
+ * - A PIPE / redirect / capture (not a TTY) is decoded by the consumer with its
+ *   own ambient code page. On zh-CN Windows that is GBK (cp936) and raw UTF-8 is
+ *   mangled by the terminal AND by PowerShell's `[Console]::OutputEncoding`
+ *   (verified on Windows PowerShell 5.1 and PowerShell 7.6) for `$x = omc …`,
+ *   `omc … > f`, and the `.ps1` shim pipe. There we escape every non-ASCII code
+ *   unit to `\uXXXX`: stdout stays pure ASCII, survives any code page, and
+ *   still `JSON.parse`s back to the original string — the same conservative
+ *   default as Python's `json.dumps(ensure_ascii=True)`.
+ *
+ * POSIX always keeps raw UTF-8. `OMC_ASCII_STDOUT=1|0` forces either mode. `--out`
+ * files, artifacts, stderr, and the CloudPivot wire stay raw UTF-8 — they are
+ * not a code-page-bound console stream. See `CONTEXT.md` → Agent-facing CLI.
  */
+export function asciiStdout() {
+    const override = process.env.OMC_ASCII_STDOUT;
+    if (override === "1")
+        return true;
+    if (override === "0")
+        return false;
+    if (process.platform !== "win32")
+        return false;
+    return process.stdout.isTTY !== true;
+}
 export function serializeEnvelope(value) {
-    return JSON.stringify(value) + "\n";
+    const json = JSON.stringify(value);
+    const escaped = asciiStdout() ? json.replace(/[\u007f-\uffff]/g, (character) => `\\u${character.charCodeAt(0).toString(16).padStart(4, "0")}`) : json;
+    return escaped + "\n";
 }
 export function requestId() {
     return randomUUID();

package/package.json

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