@amanm/openpaw 0.1.2 → 0.2.1

package/README.md

@@ -18,10 +18,11 @@ OpenPaw is a Bun + TypeScript local agent runtime with:
 Global install (recommended for end users):
 
 ```bash
-npm i -g openpaw
+npm i -g @amanm/openpaw
 ```
 
-The first `openpaw` run checks for Bun. If Bun is missing on macOS/Linux, OpenPaw prompts to install it automatically.
+After install you can run `openpaw` (and `opaw`) commands directly.
+The first run checks for Bun. If Bun is missing on macOS/Linux, OpenPaw prompts to install it automatically.
 
 Windows note: Bun auto-install is not performed yet. Install Bun manually from `https://bun.sh/docs/installation`.
 
@@ -41,6 +42,8 @@ Main commands:
 
 - `openpaw onboard`  
   Interactive onboarding (provider URL, API key, model, optional Telegram token, personality)
+- `openpaw update`  
+  Update to the latest published version (uses Bun or npm based on your global install)
 - `openpaw tui`  
   Start local terminal chat UI
 - `openpaw gateway dev`  

package/cli/openpaw.tsx

@@ -4,6 +4,8 @@ import { startGateway } from "../gateway";
 import { runOpenPawTui } from "./tui";
 import { handleOnboard } from "./onboard";
 import { handleReset } from "./reset";
+import { handleUpdate } from "./update";
+import { getOpenPawVersion } from "./version";
 import {
   getGatewayDaemonStatus,
   readGatewayDaemonLog,
@@ -11,7 +13,7 @@ import {
   stopGatewayDaemon,
 } from "../gateway/daemon-manager";
 
-program.version("0.1.0").description("OpenPaw");
+program.version(getOpenPawVersion()).description("OpenPaw");
 
 program
   .command("reset")
@@ -32,6 +34,18 @@ program
   .description("Go through the onboarding setup")
   .action(handleOnboard);
 
+program
+  .command("update")
+  .description("Update OpenPaw to the latest published release")
+  .action(() => {
+    try {
+      handleUpdate();
+    } catch (e) {
+      console.error(e instanceof Error ? e.message : e);
+      process.exitCode = 1;
+    }
+  });
+
 const gateway = program.command("gateway").description("Run messaging channel adapters (shared agent runtime)");
 
 gateway

package/cli/update.ts

@@ -0,0 +1,114 @@
+import { readFileSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+
+/** Minimal package metadata used for self-update command resolution. */
+type OpenPawPackageMeta = {
+  name?: string;
+};
+
+/** Supported global package managers for self-update behavior. */
+type GlobalPackageManager = "bun" | "npm";
+
+/**
+ * Reads package metadata from the shipped `package.json` next to the project root.
+ */
+function readPackageMeta(): OpenPawPackageMeta {
+  const cliDir = dirname(fileURLToPath(import.meta.url));
+  const packageJsonPath = join(cliDir, "..", "package.json");
+  const raw = readFileSync(packageJsonPath, "utf8");
+  return JSON.parse(raw) as OpenPawPackageMeta;
+}
+
+/**
+ * Resolves the npm package id to update. Falls back to `@amanm/openpaw` if metadata is missing.
+ */
+function resolvePackageName(): string {
+  const meta = readPackageMeta();
+  const name = meta.name?.trim();
+  return name && name.length > 0 ? name : "@amanm/openpaw";
+}
+
+/**
+ * Ensures npm is available on PATH for update operations.
+ */
+function ensureNpmAvailable(): void {
+  const check = spawnSync("npm", ["--version"], { stdio: "ignore" });
+  if (check.status !== 0) {
+    throw new Error("npm is required for `openpaw update` but was not found on PATH.");
+  }
+}
+
+/**
+ * Ensures Bun is available on PATH for update operations.
+ */
+function ensureBunAvailable(): void {
+  const check = spawnSync("bun", ["--version"], { stdio: "ignore" });
+  if (check.status !== 0) {
+    throw new Error("Bun is required for `openpaw update` in Bun-global mode but was not found.");
+  }
+}
+
+/**
+ * Returns command output lines for a shell command or an empty string on failure.
+ */
+function readCommandStdout(command: string, args: string[]): string {
+  const out = spawnSync(command, args, { encoding: "utf8" });
+  if (out.status !== 0) {
+    return "";
+  }
+  return String(out.stdout ?? "").trim();
+}
+
+/**
+ * Determines whether the current global `openpaw` command resolves from Bun or npm global bin.
+ */
+function detectGlobalPackageManager(): GlobalPackageManager {
+  const commandPath = readCommandStdout("bash", ["-lc", "command -v openpaw || command -v opaw || true"]);
+  const bunGlobalBin = readCommandStdout("bun", ["pm", "bin", "-g"]);
+  const npmGlobalBin = readCommandStdout("npm", ["bin", "-g"]);
+
+  if (commandPath && bunGlobalBin && commandPath.startsWith(bunGlobalBin)) {
+    return "bun";
+  }
+  if (commandPath && npmGlobalBin && commandPath.startsWith(npmGlobalBin)) {
+    return "npm";
+  }
+
+  // Default to npm for broader compatibility if install origin cannot be inferred.
+  return "npm";
+}
+
+/**
+ * Updates this globally-installed package to the latest published version with the matching package manager.
+ */
+export function handleUpdate(): void {
+  const packageName = resolvePackageName();
+  const target = `${packageName}@latest`;
+  const manager = detectGlobalPackageManager();
+
+  if (manager === "bun") {
+    ensureBunAvailable();
+    console.log(`Updating ${target} using Bun global install ...`);
+    const run = spawnSync("bun", ["install", "-g", target], {
+      stdio: "inherit",
+    });
+    if (run.status !== 0) {
+      throw new Error(`Update failed for ${target} using Bun.`);
+    }
+    console.log(`Updated ${packageName} to latest via Bun.`);
+    return;
+  }
+
+  ensureNpmAvailable();
+  console.log(`Updating ${target} using npm global install ...`);
+  const run = spawnSync("npm", ["install", "-g", target], {
+    stdio: "inherit",
+  });
+  if (run.status !== 0) {
+    throw new Error(`Update failed for ${target} using npm.`);
+  }
+
+  console.log(`Updated ${packageName} to latest via npm.`);
+}

package/cli/version.ts

@@ -0,0 +1,30 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+/** Partial package metadata needed for CLI version reporting. */
+type OpenPawPackageMeta = {
+  version?: string;
+};
+
+/**
+ * Reads package metadata from the repository/package root.
+ */
+function readPackageMeta(): OpenPawPackageMeta {
+  const cliDir = dirname(fileURLToPath(import.meta.url));
+  const packageJsonPath = join(cliDir, "..", "package.json");
+  const raw = readFileSync(packageJsonPath, "utf8");
+  return JSON.parse(raw) as OpenPawPackageMeta;
+}
+
+/**
+ * Returns the CLI version from package metadata, with a safe fallback.
+ */
+export function getOpenPawVersion(): string {
+  try {
+    const version = readPackageMeta().version?.trim();
+    return version && version.length > 0 ? version : "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@amanm/openpaw",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "description": "Local Bun + TypeScript agent runtime with TUI and messaging gateway adapters.",
   "repository": {
     "type": "git",
-    "url": "https://github.com/amanmprojects/openpaw"
+    "url": "git+https://github.com/amanmprojects/openpaw.git"
   },
   "homepage": "https://github.com/amanmprojects/openpaw",
   "bugs": {
@@ -13,7 +13,8 @@
   "license": "MIT",
   "type": "module",
   "bin": {
-    "openpaw": "bin/openpaw.cjs"
+    "openpaw": "bin/openpaw.cjs",
+    "opaw": "bin/openpaw.cjs"
   },
   "scripts": {
     "openpaw": "bun run ./cli/openpaw.tsx",