portable-agent-layer 0.73.0 → 0.74.0

package/package.json

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

package/src/cli/index.ts

@@ -17,7 +17,7 @@
  *   doctor                            Check prerequisites and system health
  *   usage                             Summarize token usage and cost
  *   ledger <sub> [filters]            Query the action ledger (log · show · stats)
- *   server start|stop|status          The control room, a local page over ~/.pal
+ *   server start|stop|restart|status  The control room, a local page over ~/.pal
  *   skill link <name>                 Link a personal ~/.pal/skills/<name>/ into installed agents
  *   skill doctor <name|--all>         Evaluate one skill, or every installed skill, against the authoring best practices
  *   subagent link <name>             Install a personal ~/.pal/agents/<name>.md into installed agents
@@ -342,7 +342,7 @@ function showHelp() {
                                             (search · graph · stats · hubs · find · show · add · ls)
     pal cli ledger <sub> [filters]          Query the action ledger (log · show · stats)
                                             e.g. ledger log --project X --since 7d
-    pal cli server start|stop|status        The control room: a local page to open before a terminal
+    pal cli server start|stop|restart|status  The control room: a local page to open before a terminal
     pal cli skill link <name>               Link a personal ~/.pal/skills/<name>/ into installed agents
     pal cli skill doctor <name|--all>       Evaluate one skill, or every installed skill
     pal cli skill author-model              Print the flagship model that authors skills for the active agent
@@ -1287,9 +1287,28 @@ async function install(targets: Targets) {
     `Shared: ${indexedSkills} skills indexed · ${palDocsCount} docs → ~/.pal/docs/ · AGENTS.md + context digests written`
   );
 
+  await refreshControlRoom();
+
   log.success("Done. Existing config was preserved — only new entries were added.");
 }
 
+/**
+ * A published install carries the page in its tarball; a checkout does not —
+ * ui/dist is gitignored, so a pull leaves whatever was built last. Rebuild
+ * there, then replace the process, because the API is the running code.
+ */
+async function refreshControlRoom(): Promise<void> {
+  const { isRepoMode } = await import("../hooks/handlers/update-check");
+  const { buildPage } = await import("../tools/control-room/static");
+  if (isRepoMode() && !buildPage()) {
+    log.warn("Control room page could not be rebuilt — run: bun run build:ui");
+    return;
+  }
+
+  const { restartIfRunning } = await import("./server");
+  if (await restartIfRunning()) log.success("Control room restarted on the new build");
+}
+
 async function uninstall(args: string[]) {
   const targets = parseTargets(args);
 

package/src/cli/server.ts

@@ -37,6 +37,8 @@ export async function runServer(args: string[]): Promise<number> {
       return cmdStart(rest);
     case "stop":
       return cmdStop();
+    case "restart":
+      return cmdRestart();
     case "status":
       return cmdStatus();
     case undefined:
@@ -60,6 +62,7 @@ function showHelp(): void {
   Subcommands:
     start [--port <n>]         Start the control room in the background (default port ${DEFAULT_PORT})
     stop                       Stop it
+    restart                    Replace a running one — the API only changes when the process does
     status                     Show whether it is running, and where
 
   The page listens on ${LOOPBACK} only.
@@ -156,6 +159,29 @@ async function cmdStart(args: string[]): Promise<number> {
   return 0;
 }
 
+/**
+ * The page is read off disk per request, so a rebuilt dist reaches the browser
+ * on the next reload — but the API routes are the running process's own code,
+ * and those only change when the process does.
+ */
+async function cmdRestart(): Promise<number> {
+  const running = await runningServer();
+  if (!running) {
+    console.log("Not running — nothing to restart. Use `start`.");
+    return 0;
+  }
+  await cmdStop();
+  return cmdStart(["--port", String(running.port)]);
+}
+
+/**
+ * Used by `pal cli install`: an install that leaves an old build answering on
+ * the port has not finished. A server nobody started stays unstarted.
+ */
+export async function restartIfRunning(): Promise<boolean> {
+  return (await runningServer()) !== null && (await cmdRestart()) === 0;
+}
+
 /** The state file is a claim; the process answering on that port is the fact. */
 async function runningServer(): Promise<ServerState | null> {
   const state = readState();

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

@@ -46,7 +46,7 @@ function writeCache(cache: UpdateCache): void {
   }
 }
 
-function isRepoMode(): boolean {
+export function isRepoMode(): boolean {
   return existsSync(resolve(palPkg(), ".git"));
 }