portable-agent-layer 0.7.0 → 0.8.1

package/README.md

@@ -77,6 +77,7 @@ pal cli status        # check your setup
 | `pal cli init` | Scaffold PAL home directory and install hooks |
 | `pal cli install` | Register hooks/skills for targets |
 | `pal cli uninstall` | Remove hooks/skills for targets |
+| `pal cli update` | Update PAL (git pull or npm update) and reinstall hooks |
 | `pal cli export` | Export user state (telos, memory) to a zip |
 | `pal cli import` | Import user state from a zip |
 | `pal cli status` | Show current PAL configuration |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portable-agent-layer",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "PAL — Portable Agent Layer: persistent personal context for AI coding assistants",
   "type": "module",
   "bin": {

package/src/cli/index.ts

@@ -10,6 +10,7 @@
  *   init                              Scaffold PAL home, install hooks for all targets
  *   install [--claude] [--opencode]   Register hooks/skills for targets
  *   uninstall [--claude] [--opencode] Remove hooks/skills for targets
+ *   update                             Update PAL (git pull or npm update)
  *   export [path] [--dry-run]         Export user state to zip
  *   import [path] [--dry-run]         Import user state from zip
  *   status                            Show current PAL configuration
@@ -157,6 +158,9 @@ async function runCli(command: string | undefined, args: string[]) {
     case "import":
       await importState(args);
       break;
+    case "update":
+      await update();
+      break;
     case "status":
       await status();
       break;
@@ -196,6 +200,7 @@ function showHelp() {
     pal cli init [--claude] [--opencode]    Scaffold and install (default: all)
     pal cli install [--claude] [--opencode] Register hooks for targets
     pal cli uninstall [--claude] [--opencode] Remove hooks for targets
+    pal cli update                          Update PAL (git pull or npm update)
     pal cli export [path] [--dry-run]       Export state to zip
     pal cli import [path] [--dry-run]       Import state from zip
     pal cli status                          Show PAL configuration
@@ -574,6 +579,45 @@ async function importState(args: string[]) {
   }
 }
 
+async function update() {
+  const { checkForUpdate } = await import("../hooks/handlers/update-check");
+  const result = await checkForUpdate(true);
+
+  log.info(`Current: ${result.current} (${result.mode} mode)`);
+
+  if (!result.available) {
+    log.success("Already up to date.");
+    return;
+  }
+
+  log.info(`Available: ${result.latest}`);
+
+  const pkg = palPkg();
+  if (result.mode === "repo") {
+    log.info("Pulling updates...");
+    const pull = spawnSync("git", ["pull", "--ff-only"], { cwd: pkg, stdio: "inherit" });
+    if (pull.status !== 0) {
+      log.error("git pull failed. You may have local changes — try pulling manually.");
+      process.exit(1);
+    }
+  } else {
+    log.info("Updating via npm...");
+    const up = spawnSync("bun", ["update", "-g", "portable-agent-layer"], {
+      stdio: "inherit",
+    });
+    if (up.status !== 0) {
+      log.error("Update failed. Try: bun update -g portable-agent-layer");
+      process.exit(1);
+    }
+  }
+
+  const newPkg = JSON.parse(readFileSync(resolve(pkg, "package.json"), "utf-8"));
+  log.success(`Updated: ${result.current} → ${newPkg.version}`);
+
+  log.info("Reinstalling...");
+  await install(resolveTargets([]));
+}
+
 async function status() {
   const home = palHome();
   const pkg = palPkg();

package/src/hooks/handlers/update-check.ts

@@ -152,12 +152,14 @@ async function checkNpm(): Promise<UpdateCache> {
   }
 }
 
-/** Run update check on Stop (non-blocking). Caches result for greeting. */
-export async function checkForUpdate(): Promise<void> {
-  const cached = readCache();
-  if (cached) {
-    logDebug("update-check", "Using cached result");
-    return;
+/** Run update check. Caches result. Use force=true to skip cache (e.g. for `pal cli update`). */
+export async function checkForUpdate(force = false): Promise<UpdateCache> {
+  if (!force) {
+    const cached = readCache();
+    if (cached) {
+      logDebug("update-check", "Using cached result");
+      return cached;
+    }
   }
 
   const result = isRepoMode() ? await checkRepo() : await checkNpm();
@@ -169,6 +171,8 @@ export async function checkForUpdate(): Promise<void> {
       `Update available: ${result.current} → ${result.latest} (${result.mode})`
     );
   }
+
+  return result;
 }
 
 /** Read cached update status for greeting display. Returns null if no update. */
@@ -179,10 +183,7 @@ export function getUpdateNotice(): string | null {
     const cache = JSON.parse(readFileSync(fp, "utf-8")) as UpdateCache;
     if (!cache.available) return null;
 
-    if (cache.mode === "repo") {
-      return `📦 Update available: ${cache.current} → ${cache.latest} (git pull)`;
-    }
-    return `📦 Update available: ${cache.current} → ${cache.latest} (bun update -g portable-agent-layer)`;
+    return `📦 Update available: ${cache.current} → ${cache.latest} (pal cli update)`;
   } catch {
     return null;
   }