CLI: include commit hash in --version output (#39712)

* CLI: include commit hash in --version output

* fix(version): harden commit SHA resolution and keep output consistent

* CLI: keep install checks compatible with commit-tagged version output

* fix(cli): include commit hash in root version fast path

* test(cli): allow null commit-hash mocks

* Installer: share version parser across install scripts

* Installer: avoid sourcing helpers from stdin cwd

* CLI: note commit-tagged version output

* CLI: anchor commit hash resolution to module root

* CLI: harden commit hash resolution

* CLI: fix commit hash lookup edge cases

* CLI: prefer live git metadata in dev builds

* CLI: keep git lookup inside package root

* Infra: tolerate invalid moduleUrl hints

* CLI: cache baked commit metadata fallbacks

* CLI: align changelog attribution with prep gate

* CLI: restore changelog contributor credit

---------

Co-authored-by: echoVic <echovic@163.com>
Co-authored-by: echoVic <echoVic@users.noreply.github.com>

src/entry.version-fast-path.test.ts

@@ -0,0 +1,104 @@
+import process from "node:process";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+
+const applyCliProfileEnvMock = vi.hoisted(() => vi.fn());
+const attachChildProcessBridgeMock = vi.hoisted(() => vi.fn());
+const installProcessWarningFilterMock = vi.hoisted(() => vi.fn());
+const isMainModuleMock = vi.hoisted(() => vi.fn(() => true));
+const isRootHelpInvocationMock = vi.hoisted(() => vi.fn(() => false));
+const isRootVersionInvocationMock = vi.hoisted(() => vi.fn(() => true));
+const normalizeEnvMock = vi.hoisted(() => vi.fn());
+const normalizeWindowsArgvMock = vi.hoisted(() => vi.fn((argv: string[]) => argv));
+const parseCliProfileArgsMock = vi.hoisted(() => vi.fn((argv: string[]) => ({ ok: true, argv })));
+const resolveCommitHashMock = vi.hoisted(() => vi.fn<() => string | null>(() => "abc1234"));
+const shouldSkipRespawnForArgvMock = vi.hoisted(() => vi.fn(() => true));
+
+vi.mock("./cli/argv.js", () => ({
+  isRootHelpInvocation: isRootHelpInvocationMock,
+  isRootVersionInvocation: isRootVersionInvocationMock,
+}));
+
+vi.mock("./cli/profile.js", () => ({
+  applyCliProfileEnv: applyCliProfileEnvMock,
+  parseCliProfileArgs: parseCliProfileArgsMock,
+}));
+
+vi.mock("./cli/respawn-policy.js", () => ({
+  shouldSkipRespawnForArgv: shouldSkipRespawnForArgvMock,
+}));
+
+vi.mock("./cli/windows-argv.js", () => ({
+  normalizeWindowsArgv: normalizeWindowsArgvMock,
+}));
+
+vi.mock("./infra/env.js", () => ({
+  isTruthyEnvValue: () => false,
+  normalizeEnv: normalizeEnvMock,
+}));
+
+vi.mock("./infra/git-commit.js", () => ({
+  resolveCommitHash: resolveCommitHashMock,
+}));
+
+vi.mock("./infra/is-main.js", () => ({
+  isMainModule: isMainModuleMock,
+}));
+
+vi.mock("./infra/warning-filter.js", () => ({
+  installProcessWarningFilter: installProcessWarningFilterMock,
+}));
+
+vi.mock("./process/child-process-bridge.js", () => ({
+  attachChildProcessBridge: attachChildProcessBridgeMock,
+}));
+
+vi.mock("./version.js", () => ({
+  VERSION: "9.9.9-test",
+}));
+
+describe("entry root version fast path", () => {
+  let originalArgv: string[];
+  let exitSpy: ReturnType<typeof vi.spyOn>;
+
+  beforeEach(() => {
+    vi.resetModules();
+    vi.clearAllMocks();
+    originalArgv = [...process.argv];
+    process.argv = ["node", "openclaw", "--version"];
+    exitSpy = vi
+      .spyOn(process, "exit")
+      .mockImplementation(((_code?: number) => undefined) as typeof process.exit);
+  });
+
+  afterEach(() => {
+    process.argv = originalArgv;
+    exitSpy.mockRestore();
+  });
+
+  it("prints commit-tagged version output when commit metadata is available", async () => {
+    const logSpy = vi.spyOn(console, "log").mockImplementation(() => {});
+
+    await import("./entry.js");
+
+    await vi.waitFor(() => {
+      expect(logSpy).toHaveBeenCalledWith("OpenClaw 9.9.9-test (abc1234)");
+      expect(exitSpy).toHaveBeenCalledWith(0);
+    });
+
+    logSpy.mockRestore();
+  });
+
+  it("falls back to plain version output when commit metadata is unavailable", async () => {
+    resolveCommitHashMock.mockReturnValueOnce(null);
+    const logSpy = vi.spyOn(console, "log").mockImplementation(() => {});
+
+    await import("./entry.js");
+
+    await vi.waitFor(() => {
+      expect(logSpy).toHaveBeenCalledWith("OpenClaw 9.9.9-test");
+      expect(exitSpy).toHaveBeenCalledWith(0);
+    });
+
+    logSpy.mockRestore();
+  });
+});