@hienlh/ppm 0.13.30 → 0.13.31

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [0.13.31] - 2026-04-25
+
+### Fixed
+- **Windows restart fails with SIGUSR2 error**: `ppm restart` on Windows threw `TypeError [ERR_UNKNOWN_SIGNAL]: Unknown signal: SIGUSR2` — Unix signals don't exist on Windows. Now writes command file that supervisor polls every 1s (same mechanism as upgrade). Also fixed `ppm start` sending SIGUSR1/SIGUSR2 directly on Windows for resume/upgrade paths
+
 ## [0.13.30] - 2026-04-25
 
 ### Fixed

package/assets/skills/ppm/SKILL.md

@@ -71,4 +71,4 @@ This skill covers the `ppm` CLI, its HTTP API, and its config DB. It does **not*
 - Third-party extensions (inspect via `ppm ext list`).
 - The Claude Agent SDK internals (separate skill).
 
-<!-- Generated for PPM v0.13.30 at build time. Re-run `ppm export skill --install` to refresh. -->
+<!-- Generated for PPM v0.13.31 at build time. Re-run `ppm export skill --install` to refresh. -->

package/assets/skills/ppm/references/http-api.md

@@ -201,4 +201,4 @@ _Base URL: `http://localhost:8080` (default; override via `ppm config set port <
 - `ws://<host>/ws/terminal` — PTY terminal multiplexer
 - `ws://<host>/ws/extensions` — extension host channel
 
-<!-- Generated from src/server/routes/ for PPM v0.13.30 -->
+<!-- Generated from src/server/routes/ for PPM v0.13.31 -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hienlh/ppm",
-  "version": "0.13.30",
+  "version": "0.13.31",
   "description": "Personal Project Manager — mobile-first web IDE with AI assistance",
   "author": "hienlh",
   "license": "MIT",

package/src/cli/commands/restart.ts

@@ -74,9 +74,14 @@ export async function restartServer(options: { force?: boolean }) {
     console.log("\n  Restarting PPM server via supervisor...");
     console.log("  If you're using PPM terminal, wait a few seconds for auto-reconnect.\n");
 
-    try { process.kill(supervisorPid, "SIGUSR2"); } catch (e) {
-      console.error(`  ✗  Failed to signal supervisor: ${e}`);
-      process.exit(1);
+    if (process.platform === "win32") {
+      const cmdFile = resolve(getPpmDir(), ".supervisor-cmd");
+      writeFileSync(cmdFile, JSON.stringify({ action: "restart" }));
+    } else {
+      try { process.kill(supervisorPid, "SIGUSR2"); } catch (e) {
+        console.error(`  ✗  Failed to signal supervisor: ${e}`);
+        process.exit(1);
+      }
     }
 
     // Wait for new server PID to appear in status.json (up to 15s)

package/src/server/index.ts

@@ -269,15 +269,26 @@ export async function startServer(options: {
             const state = status.state as string;
             const runningVersion = status.serverVersion as string;
 
+            // Helper: send signal (Unix) or write command file (Windows)
+            const signalSupervisor = (signal: "SIGUSR1" | "SIGUSR2", cmdAction?: string) => {
+              if (process.platform === "win32") {
+                const cmdFile = resolve(ppmDir, ".supervisor-cmd");
+                const action = cmdAction ?? (signal === "SIGUSR1" ? "upgrade" : "restart");
+                writeFileSync(cmdFile, JSON.stringify({ action }));
+              } else {
+                process.kill(supervisorPid, signal);
+              }
+            };
+
             if (state === "stopped") {
               console.log("  Supervisor is alive (stopped state). Resuming server...");
               if (runningVersion !== VERSION) {
                 console.log(`  Upgrading: ${runningVersion} -> ${VERSION}`);
-                process.kill(supervisorPid, "SIGUSR1");
+                signalSupervisor("SIGUSR1");
                 await waitForNewSupervisor(statusFile, supervisorPid);
               } else {
                 writeCmd("resume");
-                process.kill(supervisorPid, "SIGUSR2");
+                signalSupervisor("SIGUSR2", "resume");
                 await waitForServerReady(statusFile, port);
               }
               return;
@@ -286,7 +297,7 @@ export async function startServer(options: {
             if (state === "running") {
               if (runningVersion !== VERSION) {
                 console.log(`  Supervisor running (v${runningVersion}). Upgrading to v${VERSION}...`);
-                process.kill(supervisorPid, "SIGUSR1");
+                signalSupervisor("SIGUSR1");
                 await waitForNewSupervisor(statusFile, supervisorPid);
               } else {
                 console.log(`\n  PPM is already running (PID: ${supervisorPid}).`);
@@ -299,7 +310,7 @@ export async function startServer(options: {
             if (state === "paused") {
               console.log("  Supervisor is paused (max restarts). Sending resume...");
               writeCmd("resume");
-              process.kill(supervisorPid, "SIGUSR2");
+              signalSupervisor("SIGUSR2", "resume");
               await waitForServerReady(statusFile, port);
               return;
             }

package/src/services/supervisor-state.ts

@@ -71,7 +71,7 @@ export function writeStatus(data: Record<string, unknown>) {
 }
 
 // ─── Command file protocol ─────────────────────────────────────────────
-export type CmdAction = "soft_stop" | "resume";
+export type CmdAction = "soft_stop" | "resume" | "restart";
 
 /** Atomically claim + read command file (rename to .claimed, read, delete) */
 export function readAndDeleteCmd(): { action: CmdAction } | null {

package/src/services/supervisor.ts

@@ -985,6 +985,15 @@ export async function runSupervisor(opts: {
       else if (cmd.action === "resume") {
         if (getState() === "stopped" || getState() === "paused") triggerResume();
       }
+      else if (cmd.action === "restart") {
+        log("INFO", "Windows command: restart server only");
+        if (getState() === "paused" || getState() === "stopped") {
+          triggerResume();
+        } else if (serverChild) {
+          serverRestartRequested = true;
+          try { serverChild.kill(); } catch {}
+        }
+      }
       else if (cmd.action === "upgrade") {
         log("INFO", "Windows command: upgrade, starting self-replace");
         selfReplace().then((result) => {