@pushpalsdev/cli 1.0.1

package/README.md

@@ -0,0 +1,36 @@
+# @pushpalsdev/cli
+
+Terminal-first PushPals client that routes chat through `LocalBuddy -> RemoteBuddy`.
+
+## Install
+
+```bash
+npm i -g @pushpalsdev/cli
+```
+
+or:
+
+```bash
+bun install -g @pushpalsdev/cli
+```
+
+## Run
+
+From a git repository that is attached to your running PushPals stack:
+
+```bash
+pushpals
+```
+
+The CLI hard-fails if:
+
+- current directory is not a git repository
+- LocalBuddy is unavailable
+- LocalBuddy is attached to a different repo root
+- Bun runtime is not installed (for npm-installed entrypoint execution)
+
+## No npm/Bun install
+
+Download native binaries from GitHub Releases:
+
+https://github.com/PushPalsDev/pushpals/releases

package/bin/pushpals.cjs

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+"use strict";
+
+const { spawn, spawnSync } = require("node:child_process");
+const { existsSync } = require("node:fs");
+const { resolve } = require("node:path");
+
+const bundledCliPath = resolve(__dirname, "..", "dist", "pushpals-cli.js");
+const releaseUrl = "https://github.com/PushPalsDev/pushpals/releases";
+
+function fail(lines) {
+  for (const line of lines) {
+    process.stderr.write(`${line}\n`);
+  }
+  process.exit(1);
+}
+
+if (!existsSync(bundledCliPath)) {
+  fail([
+    "[pushpals] CLI bundle is missing in this package install.",
+    "[pushpals] Reinstall @pushpalsdev/cli, or download a direct binary from:",
+    `[pushpals] ${releaseUrl}`,
+  ]);
+}
+
+function hasBunRuntime() {
+  if (process.platform === "win32") {
+    const probe = spawnSync("bun --version", { shell: true, stdio: "ignore" });
+    return probe.status === 0;
+  }
+  const probe = spawnSync("bun", ["--version"], { stdio: "ignore" });
+  return probe.status === 0;
+}
+
+if (!hasBunRuntime()) {
+  fail([
+    "[pushpals] Bun runtime is required for the npm package entrypoint.",
+    "[pushpals] Install Bun from https://bun.sh, or use a direct binary release:",
+    `[pushpals] ${releaseUrl}`,
+  ]);
+}
+
+function spawnBunCli() {
+  if (process.platform !== "win32") {
+    return spawn("bun", [bundledCliPath, ...process.argv.slice(2)], {
+      stdio: "inherit",
+      env: process.env,
+    });
+  }
+
+  const quoteWindows = (value) => `"${String(value).replace(/"/g, '\\"')}"`;
+  const commandLine = [
+    "bun",
+    quoteWindows(bundledCliPath),
+    ...process.argv.slice(2).map(quoteWindows),
+  ].join(" ");
+  return spawn(commandLine, {
+    shell: true,
+    stdio: "inherit",
+    env: process.env,
+  });
+}
+
+const child = spawnBunCli();
+
+child.on("error", (err) => {
+  fail([`[pushpals] Failed to launch Bun runtime: ${String(err?.message ?? err)}`]);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exit(code ?? 1);
+});