feat(cli): add plebbit-js version and commit to --version output

Display plebbit-js version and git commit hash on a second line when
running bitsocial --version. This helps users identify which version
of the plebbit-js library is bundled with their CLI installation.

Output format:
bitsocial-cli/0.18.0 linux-x64 node-v22.18.0
plebbit-js/0.0.8 (a21d896)

Author: Rinse12

src/cli/hooks/init/version-hook.ts

@@ -0,0 +1,48 @@
+import { Hook } from "@oclif/core";
+import { createRequire } from "module";
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+
+// Get plebbit-js version from its package.json
+const getPlebbitJsVersion = (): string => {
+    const require = createRequire(import.meta.url);
+    // Get path to plebbit-js module
+    const plebbitJsPath = require.resolve("@plebbit/plebbit-js");
+    // Navigate to package root (plebbit-js main export is dist/node/index.js)
+    const plebbitJsRoot = dirname(dirname(dirname(plebbitJsPath)));
+    const plebbitPkgPath = join(plebbitJsRoot, "package.json");
+    const plebbitPkg = JSON.parse(readFileSync(plebbitPkgPath, "utf-8"));
+    return plebbitPkg.version;
+};
+
+// Get commit hash from CLI's package.json dependency URL
+const getPlebbitJsCommit = (cliRoot: string): string | undefined => {
+    try {
+        const cliPkgPath = join(cliRoot, "package.json");
+        const cliPkg = JSON.parse(readFileSync(cliPkgPath, "utf-8"));
+        const plebbitJsDep = cliPkg.dependencies["@plebbit/plebbit-js"];
+        // Extract commit hash from URL like "https://github.com/plebbit/plebbit-js#a21d896bd55c76070758dae65dc0693d1c3726db"
+        const match = plebbitJsDep?.match(/#([a-f0-9]+)$/);
+        return match ? match[1].substring(0, 7) : undefined;
+    } catch {
+        return undefined;
+    }
+};
+
+const hook: Hook<"init"> = async function (opts) {
+    // Check process.argv because oclif normalizes argv and --version becomes the id, not part of argv
+    if (process.argv.includes("--version")) {
+        const { config } = opts;
+        const plebbitJsVersion = getPlebbitJsVersion();
+        const commit = getPlebbitJsCommit(config.root);
+        const commitStr = commit ? ` (${commit})` : "";
+
+        // Output CLI version on first line, plebbit-js version + commit on second line
+        this.log(`${config.name}/${config.version} ${config.platform}-${config.arch} node-${process.version}`);
+        this.log(`plebbit-js/${plebbitJsVersion}${commitStr}`);
+        // Use process.exit to actually stop - this.exit(0) throws an error that gets caught by oclif
+        process.exit(0);
+    }
+};
+
+export default hook;

test/cli/version.test.ts

@@ -0,0 +1,63 @@
+import { spawn } from "child_process";
+import { describe, it, expect } from "vitest";
+import { join } from "path";
+import { readFileSync } from "fs";
+
+const CLI_PATH = join(process.cwd(), "bin", "run");
+const PACKAGE_JSON_PATH = join(process.cwd(), "package.json");
+
+// Get expected values from package.json
+const getExpectedValues = () => {
+    const cliPkg = JSON.parse(readFileSync(PACKAGE_JSON_PATH, "utf-8"));
+    const cliVersion = cliPkg.version;
+    const plebbitJsDep = cliPkg.dependencies["@plebbit/plebbit-js"];
+    // Extract commit hash from URL like "https://github.com/plebbit/plebbit-js#a21d896bd55c76070758dae65dc0693d1c3726db"
+    const commitMatch = plebbitJsDep?.match(/#([a-f0-9]+)$/);
+    const commit = commitMatch ? commitMatch[1].substring(0, 7) : undefined;
+    return { cliVersion, commit };
+};
+
+describe("bitsocial --version", () => {
+    it("should print CLI version and plebbit-js version with commit hash", async () => {
+        const { cliVersion, commit } = getExpectedValues();
+
+        const result = await new Promise<{ stdout: string; stderr: string; exitCode: number | null }>((resolve) => {
+            const proc = spawn("node", [CLI_PATH, "--version"], {
+                cwd: process.cwd(),
+                env: { ...process.env }
+            });
+
+            let stdout = "";
+            let stderr = "";
+
+            proc.stdout.on("data", (data) => {
+                stdout += data.toString();
+            });
+
+            proc.stderr.on("data", (data) => {
+                stderr += data.toString();
+            });
+
+            proc.on("close", (exitCode) => {
+                resolve({ stdout, stderr, exitCode });
+            });
+        });
+
+        expect(result.exitCode).toBe(0);
+
+        const lines = result.stdout.trim().split("\n");
+        expect(lines.length).toBe(2);
+
+        // First line should contain CLI name and version
+        expect(lines[0]).toContain("bitsocial-cli");
+        expect(lines[0]).toContain(cliVersion);
+        expect(lines[0]).toMatch(/linux-x64|darwin-x64|darwin-arm64|win32-x64/);
+        expect(lines[0]).toMatch(/node-v\d+\.\d+\.\d+/);
+
+        // Second line should contain plebbit-js version and commit
+        expect(lines[1]).toContain("plebbit-js/");
+        if (commit) {
+            expect(lines[1]).toContain(`(${commit})`);
+        }
+    });
+});