@lightupai/polaris 0.0.80 → 0.0.82

package/README.md

@@ -77,7 +77,7 @@ npm install -g @lightupai/polaris
 polaris
 
 # Or run steps independently:
-polaris install          # Install MCP server, hooks, skill, status line (no auth)
+polaris install          # Install MCP server, hooks, skill, status line + restart daemon
 polaris login            # Authenticate against production
 polaris login --local    # Authenticate against localhost (for local dev)
 
@@ -87,12 +87,22 @@ polaris use local        # Switch to local dev
 polaris use prod         # Switch to production
 
 # Other commands
-polaris daemon           # Start the local daemon
+polaris daemon           # Start the local daemon (kills any existing daemon first)
 polaris status           # Show active profile, daemon state, sessions
 polaris logout           # Remove active profile credentials
 polaris logout --all     # Remove all credentials
 ```
 
+### Upgrading
+
+Because `polaris` is a **global install**, use `npm install -g` to upgrade — not `npx`:
+
+```sh
+npm install -g @lightupai/polaris@latest
+```
+
+`npx @lightupai/polaris@latest` will work for first-time installs but won't override a global binary already in `PATH`. The CLI warns you at startup if a newer version is available.
+
 ## Configuration
 
 Copy `.env.example` to `.env` and fill in your credentials. All settings are loaded by the Makefile and passed to services.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightupai/polaris",
-  "version": "0.0.80",
+  "version": "0.0.82",
   "description": "Record and stream Claude Code sessions to Slack. Like Gong for AI coding — capture every prompt, response, and tool call. Multiplayer collaboration across AI coding agents.",
   "keywords": [
     "claude-code",

package/src/cli/cli.ts

@@ -486,6 +486,23 @@ async function profiles() {
 
 // --- Daemon ---
 
+async function killExistingDaemon(): Promise<void> {
+  // Ask the running daemon to shut down gracefully via the HTTP API, then
+  // wait briefly for the port to free up. Falls back silently if no daemon
+  // is running or the port is already free.
+  try {
+    const secret = await ensureDaemonSecret();
+    const headers: Record<string, string> = { "Content-Type": "application/json" };
+    if (secret) headers["x-polaris-daemon-secret"] = secret;
+    await fetch("http://127.0.0.1:4322/shutdown", { method: "POST", headers }).catch(() => {});
+  } catch { /* no daemon running */ }
+  // Give it a moment to exit, then kill any straggler by port
+  await new Promise((r) => setTimeout(r, 500));
+  try {
+    Bun.spawnSync(["sh", "-c", "lsof -ti :4322 | xargs kill -9 2>/dev/null || true"]);
+  } catch { /* best-effort */ }
+}
+
 async function daemon() {
   const daemonPath = join(import.meta.dir, "..", "daemon", "daemon.ts");
   console.log("Starting Polaris daemon...");
@@ -761,6 +778,23 @@ async function logout(all = false) {
   console.log("MCP config and hooks are still installed — run `polaris install` to reset them.");
 }
 
+// --- Update check ---
+// Warn if a newer version is available on npm. Best-effort: never blocks startup.
+
+async function checkForUpdate(): Promise<void> {
+  try {
+    const pkgPath = join(import.meta.dir, "..", "..", "package.json");
+    const { version: current } = JSON.parse(await readFile(pkgPath, "utf-8")) as { version: string };
+    const res = await fetch("https://registry.npmjs.org/@lightupai/polaris/latest", { signal: AbortSignal.timeout(3000) });
+    if (!res.ok) return;
+    const { version: latest } = await res.json() as { version: string };
+    if (latest !== current) {
+      console.error(`\n⚠  A newer version of Polaris is available: ${latest} (you have ${current})`);
+      console.error("   Run: npm install -g @lightupai/polaris@latest\n");
+    }
+  } catch { /* best-effort — network may be unavailable */ }
+}
+
 // --- Main ---
 
 const args = process.argv.slice(2);
@@ -776,10 +810,23 @@ function hasFlag(name: string): boolean {
   return args.includes(`--${name}`);
 }
 
+void checkForUpdate();
+
 switch (command) {
   case "install":
     console.log("Polaris — installing local components\n");
     await install();
+    // Restart daemon so it picks up any updates in the new package
+    await killExistingDaemon();
+    {
+      const daemonPath = join(import.meta.dir, "..", "daemon", "daemon.ts");
+      Bun.spawn(["bun", "run", daemonPath], {
+        stdout: "ignore",
+        stderr: "ignore",
+        env: { ...process.env },
+      }).unref?.();
+    }
+    console.log("  ✓ Daemon restarted");
     console.log("\nInstall complete.");
     break;
 
@@ -789,7 +836,8 @@ switch (command) {
     console.log("Polaris — authenticating\n");
     await login(appUrl, profileName);
     console.log("\n✓ Login complete!");
-    // Auto-start daemon in background
+    // Replace any existing daemon with the current version
+    await killExistingDaemon();
     const daemonPath = join(import.meta.dir, "..", "daemon", "daemon.ts");
     Bun.spawn(["bun", "run", daemonPath], {
       stdout: "ignore",
@@ -815,6 +863,7 @@ switch (command) {
     break;
 
   case "daemon":
+    await killExistingDaemon();
     await daemon();
     break;
 
@@ -839,7 +888,8 @@ switch (command) {
     console.log("[2/2] Authenticating...\n");
     await login(DEFAULT_APP_URL);
     console.log("\n✓ Polaris is set up on this machine!");
-    // Auto-start daemon in background
+    // Replace any existing daemon with the current version
+    await killExistingDaemon();
     const daemonPath = join(import.meta.dir, "..", "daemon", "daemon.ts");
     Bun.spawn(["bun", "run", daemonPath], {
       stdout: "ignore",

package/src/daemon/daemon.ts

@@ -884,6 +884,13 @@ export function startDaemon(port = Number(process.env.POLARIS_DAEMON_PORT ?? 432
         }
       }
 
+      // POST /shutdown — graceful shutdown (used by `polaris install` to replace an old daemon)
+      if (method === "POST" && pathname === "/shutdown") {
+        // Respond first, then exit after a short delay so the response is delivered
+        setTimeout(() => process.exit(0), 100);
+        return json({ status: "shutting_down" });
+      }
+
       return error("Not found", 404);
     },
   });