ping-a-human-pi 0.1.0 → 0.1.1

package/README.md

@@ -36,6 +36,7 @@ A standalone command (no pi required) for pinging a human from any terminal:
 pah ping "build finished"      # fire-and-forget notification
 pah notify "deploy started"    # alias for ping
 pah ask "ship to prod?"        # waits and prints the human's reply
+pah --version                  # CLI version + the ping-a-human server version
 pah help
 ```
 

package/bin/pah

@@ -5,6 +5,7 @@
  *   pah ping [message...]     send a Telegram notification (fire-and-forget)
  *   pah notify [message...]   alias for `ping`
  *   pah ask <question...>     ask a human and print their reply (waits)
+ *   pah --version             print the CLI and server versions
  *   pah help                  show usage
  *
  * Reads server config from ~/.pi/agent/ping-a-human.json if present
@@ -14,11 +15,23 @@
 import { spawn } from "node:child_process";
 import { readFileSync } from "node:fs";
 import { homedir } from "node:os";
-import { join } from "node:path";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 
 const PROTOCOL_VERSION = "2024-11-05";
 const TIMEOUT_MS = 600_000;
 
+/** This CLI's version, read from ping-a-human-pi's package.json (bin/ -> ../). */
+function cliVersion() {
+	try {
+		const here = dirname(fileURLToPath(import.meta.url));
+		const pkg = JSON.parse(readFileSync(join(here, "..", "package.json"), "utf8"));
+		return pkg.version ?? "unknown";
+	} catch {
+		return "unknown";
+	}
+}
+
 function loadServer() {
 	const candidates = [process.env.PING_A_HUMAN_PI_CONFIG, join(homedir(), ".pi", "agent", "ping-a-human.json")].filter(Boolean);
 	for (const path of candidates) {
@@ -48,6 +61,8 @@ class McpClient {
 		this.env = env;
 	}
 
+	serverInfo = null;
+
 	async start() {
 		this.#proc = spawn(this.command, this.args, { env: { ...process.env, ...(this.env ?? {}) }, stdio: ["pipe", "pipe", "pipe"] });
 		this.#proc.on("error", (e) => this.#failAll(new Error(`ping-a-human: ${e.message}`)));
@@ -56,7 +71,8 @@ class McpClient {
 		this.#proc.stdout.on("data", (c) => this.#onData(c));
 		this.#proc.stderr.setEncoding("utf8");
 		this.#proc.stderr.on("data", () => {});
-		await this.#req("initialize", { protocolVersion: PROTOCOL_VERSION, capabilities: {}, clientInfo: { name: "pah-cli", version: "1.0.0" } });
+		const init = await this.#req("initialize", { protocolVersion: PROTOCOL_VERSION, capabilities: {}, clientInfo: { name: "pah-cli", version: "1.0.0" } });
+		this.serverInfo = init?.serverInfo ?? null;
 		this.#notify("notifications/initialized");
 	}
 
@@ -129,6 +145,7 @@ function usage() {
 			'  pah ping [message...]     send a notification (fire-and-forget)',
 			'  pah notify [message...]   alias for ping',
 			'  pah ask <question...>     ask a human and print their reply (waits)',
+			"  pah --version             print the CLI and server versions",
 			"  pah help                  show this help",
 			"",
 			"Examples:",
@@ -148,6 +165,22 @@ async function main() {
 		process.exit(cmd ? 0 : 1);
 	}
 
+	if (cmd === "--version" || cmd === "-v" || cmd === "version") {
+		process.stdout.write(`pah (ping-a-human-pi) ${cliVersion()}\n`);
+		// Best-effort: also report the ping-a-human server version it launches.
+		const client = new McpClient(loadServer());
+		try {
+			await client.start();
+			const v = client.serverInfo?.version;
+			process.stdout.write(`ping-a-human server ${v ?? "unknown"}\n`);
+		} catch (err) {
+			process.stdout.write(`ping-a-human server unavailable (${err.message})\n`);
+		} finally {
+			client.stop();
+		}
+		process.exit(0);
+	}
+
 	const client = new McpClient(loadServer());
 	try {
 		await client.start();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ping-a-human-pi",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Human-in-the-loop and notifications for the pi coding agent, powered by ping-a-human. One command: npx ping-a-human-pi.",
   "type": "module",
   "bin": {
@@ -16,7 +16,15 @@
   "engines": {
     "node": ">=18"
   },
-  "keywords": ["pi-package", "pi", "mcp", "ping-a-human", "human-in-the-loop", "notifications", "cli"],
+  "keywords": [
+    "pi-package",
+    "pi",
+    "mcp",
+    "ping-a-human",
+    "human-in-the-loop",
+    "notifications",
+    "cli"
+  ],
   "repository": {
     "type": "git",
     "url": "git+https://github.com/startriseio/ping-a-human.git",
@@ -28,7 +36,9 @@
   },
   "license": "MIT",
   "pi": {
-    "extensions": ["./extension"]
+    "extensions": [
+      "./extension"
+    ]
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "*",