@stalfh233/omc-cli 0.4.14 → 0.4.15

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.14`，尚未宣称 `1.0.0` 稳定契约。
+本包（`@stalfh233/omc-cli`，可执行命令仍是 `omc`）通过公共 npm registry 分发。`omc-core` 是 `omc-cli` 的内部依赖，发布时先发 `omc-core`，再发 `omc-cli`；两者版本保持一致。当前版本为 `0.4.15`，尚未宣称 `1.0.0` 稳定契约。
 
 ### 使用已发布包
 
 ```bash
-npm install -g @stalfh233/omc-cli@0.4.14
+npm install -g @stalfh233/omc-cli@0.4.15
 omc setup
 omc doctor
 omc help omc-write-hazards

package/dist/cli.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { createInterface } from "node:readline/promises";
 import { stdin, argv } from "node:process";
+import { createRequire } from "node:module";
 import { Command, CommanderError } from "commander";
 import { ConfigStore, defaultPaths, removedProfileKeys } from "./config-store.js";
 import { loadCoverageManifest, versionFamilyNotice } from "./coverage.js";
@@ -1309,6 +1310,15 @@ async function main() {
     let commandExitCode = 0;
     beginUsage(argv);
     const command = new Command();
+    const ownPackageVersion = () => {
+        try {
+            // ESM 下读自身包根的 package.json（安装形态与源码形态都成立）
+            return String(createRequire(import.meta.url)("../package.json").version);
+        }
+        catch {
+            return "unknown";
+        }
+    };
     try {
         configureOutput(argv);
     }
@@ -1320,6 +1330,13 @@ async function main() {
     command.exitOverride();
     command.configureOutput({ writeOut: (text) => process.stderr.write(text), writeErr: (text) => process.stderr.write(text) });
     command.name("omc").showHelpAfterError().showSuggestionAfterError(true);
+    // --version 短路：commander 的 version 走 process.exit，会被 exitOverride 包成
+    // invalid-input 信封（exit 10）；cpdocs --omc-global 的探测要干净的 exit 0。
+    const bare = argv.slice(2).filter((a) => a !== "--");
+    if (bare.includes("--version") || bare.includes("-V")) {
+        process.stdout.write(`${ownPackageVersion()}\n`);
+        return 0;
+    }
     command.addHelpText("after", `\n${onboardingHelp()}\n`);
     // No command at all: guide the agent (help text + onboarding), exit 0. This
     // is a benign "show me the surface" invocation, not a failure.
@@ -1388,7 +1405,9 @@ function finish(code) {
 }
 const request = requestId();
 main().then((code) => {
-    if (argv[2] === "call" || argv[2] === "artifact" || argv[2] === "commands" || argv[2] === "describe" || argv[2] === "contract" || argv[2] === "capabilities" || argv[2] === "capability" || argv[2] === "next" || argv[2] === "usage" || argv[2] === "intent" || argv[2] === "help") {
+    // Commands that own their stdout never grow a trailing envelope. `--version`/
+    // `-V` are here because their short-circuit already wrote the bare version.
+    if (argv[2] === "call" || argv[2] === "artifact" || argv[2] === "commands" || argv[2] === "describe" || argv[2] === "contract" || argv[2] === "capabilities" || argv[2] === "capability" || argv[2] === "next" || argv[2] === "usage" || argv[2] === "intent" || argv[2] === "help" || argv[2] === "--version" || argv[2] === "-V") {
         completeUsage(code);
         finish(code);
         return;

package/package.json

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