@lightupai/polaris 0.0.96 → 0.0.98

package/.github/workflows/ci.yml

@@ -43,32 +43,6 @@ jobs:
 
       - run: bun test
 
-  publish:
-    needs: test
-    runs-on: ubuntu-latest
-    if: github.ref == 'refs/heads/master' && github.event_name == 'push'
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-
-      - run: bun install
-
-      - name: Bump version from npm registry and publish
-        run: |
-          echo "//registry.npmjs.org/:_authToken=${{ secrets.NPM_TOKEN }}" > .npmrc
-          PUBLISHED=$(npm view @lightupai/polaris version 2>/dev/null || echo "0.0.0")
-          # Bump patch from the latest published version
-          IFS='.' read -r MAJOR MINOR PATCH <<< "$PUBLISHED"
-          NEW="$MAJOR.$MINOR.$((PATCH + 1))"
-          echo "Published: $PUBLISHED → Publishing: $NEW"
-          # Set version in package.json for this publish only (not committed)
-          npm version "$NEW" --no-git-tag-version
-          npm publish --access public
-
   deploy:
     needs: test
     runs-on: ubuntu-latest

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightupai/polaris",
-  "version": "0.0.96",
+  "version": "0.0.98",
   "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/skills/polaris/SKILL.md

@@ -45,4 +45,8 @@ Based on the arguments provided, do ONE of the following:
 1. Call `polaris_status`
 2. Display the current connection state
 
+### Daemon
+
+The Polaris daemon runs locally and is managed automatically — do NOT manually configure launchd or systemd. If the user reports the daemon is down or not starting at login, tell them to run `polaris install` which sets up auto-restart (launchd on macOS, systemd user service on Linux).
+
 ### Arguments: $ARGUMENTS

package/src/cli/cli.ts

@@ -107,6 +107,159 @@ function appToApi(appUrl: string): string {
   return appUrl.replace("app.", "api.");
 }
 
+// --- Daemon auto-restart (macOS: launchd, Linux: systemd user service) ---
+
+// macOS: LaunchAgent
+const LAUNCH_AGENT_LABEL = "ai.withpolaris.daemon";
+const LAUNCH_AGENT_PLIST = join(homedir(), "Library", "LaunchAgents", `${LAUNCH_AGENT_LABEL}.plist`);
+
+async function installLaunchAgent(daemonSecret?: string): Promise<void> {
+  const binDir = join(POLARIS_DIR, "bin");
+  const runnerPath = join(binDir, "run-daemon.sh");
+  const daemonTsPath = join(
+    POLARIS_DIR, "mcp", "node_modules", "@lightupai", "polaris", "src", "daemon", "daemon.ts"
+  );
+
+  await mkdir(binDir, { recursive: true });
+  // Runner searches common bun locations so launchd's minimal PATH is not an issue
+  const runner = [
+    "#!/bin/sh",
+    `# Polaris daemon — managed by launchd (${LAUNCH_AGENT_LABEL})`,
+    `for BUNPATH in "$HOME/.bun/bin/bun" /opt/homebrew/bin/bun /usr/local/bin/bun; do`,
+    `  [ -x "$BUNPATH" ] && break`,
+    `done`,
+    `exec "$BUNPATH" run "${daemonTsPath}"`,
+  ].join("\n") + "\n";
+  await writeFile(runnerPath, runner);
+  await chmod(runnerPath, 0o755);
+
+  const secretEnv = daemonSecret
+    ? `\n  <key>EnvironmentVariables</key>\n  <dict>\n    <key>POLARIS_DAEMON_SECRET</key>\n    <string>${daemonSecret}</string>\n  </dict>`
+    : "";
+  const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${LAUNCH_AGENT_LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${runnerPath}</string>
+  </array>${secretEnv}
+  <key>KeepAlive</key>
+  <true/>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>ThrottleInterval</key>
+  <integer>5</integer>
+  <key>StandardOutPath</key>
+  <string>/tmp/polaris-daemon.log</string>
+  <key>StandardErrorPath</key>
+  <string>/tmp/polaris-daemon.log</string>
+</dict>
+</plist>`;
+
+  await mkdir(join(homedir(), "Library", "LaunchAgents"), { recursive: true });
+  await writeFile(LAUNCH_AGENT_PLIST, plist);
+
+  // Unload any existing instance, then load fresh (ignore errors if not loaded yet)
+  Bun.spawnSync(["launchctl", "unload", "-w", LAUNCH_AGENT_PLIST], { stdout: "ignore", stderr: "ignore" });
+  const load = Bun.spawnSync(["launchctl", "load", "-w", LAUNCH_AGENT_PLIST], { stdout: "pipe", stderr: "pipe" });
+  if (load.exitCode !== 0) {
+    console.error(`  Warning: could not register daemon with launchd: ${load.stderr.toString().trim()}`);
+    console.error(`  Try manually: launchctl load -w ${LAUNCH_AGENT_PLIST}`);
+  }
+}
+
+async function removeLaunchAgent(): Promise<void> {
+  Bun.spawnSync(["launchctl", "unload", "-w", LAUNCH_AGENT_PLIST], { stdout: "ignore", stderr: "ignore" });
+  try { await rm(LAUNCH_AGENT_PLIST); } catch { /* already gone */ }
+}
+
+// Linux: systemd user service
+const SYSTEMD_SERVICE_NAME = "polaris-daemon";
+const SYSTEMD_USER_DIR = join(homedir(), ".config", "systemd", "user");
+const SYSTEMD_SERVICE_FILE = join(SYSTEMD_USER_DIR, `${SYSTEMD_SERVICE_NAME}.service`);
+
+async function installSystemdService(daemonSecret?: string): Promise<void> {
+  const binDir = join(POLARIS_DIR, "bin");
+  const runnerPath = join(binDir, "run-daemon.sh");
+  const daemonTsPath = join(
+    POLARIS_DIR, "mcp", "node_modules", "@lightupai", "polaris", "src", "daemon", "daemon.ts"
+  );
+
+  await mkdir(binDir, { recursive: true });
+  // Runner searches common bun install locations — systemd user units inherit a
+  // minimal PATH that may not include ~/.bun/bin
+  const runner = [
+    "#!/bin/sh",
+    `# Polaris daemon — managed by systemd (${SYSTEMD_SERVICE_NAME}.service)`,
+    `for BUNPATH in "$HOME/.bun/bin/bun" /usr/local/bin/bun /usr/bin/bun; do`,
+    `  [ -x "$BUNPATH" ] && break`,
+    `done`,
+    `exec "$BUNPATH" run "${daemonTsPath}"`,
+  ].join("\n") + "\n";
+  await writeFile(runnerPath, runner);
+  await chmod(runnerPath, 0o755);
+
+  const secretLine = daemonSecret ? `Environment=POLARIS_DAEMON_SECRET=${daemonSecret}\n` : "";
+  const unit = `[Unit]
+Description=Polaris daemon
+After=network.target
+
+[Service]
+Type=simple
+ExecStart=${runnerPath}
+Restart=always
+RestartSec=5
+${secretLine}StandardOutput=append:/tmp/polaris-daemon.log
+StandardError=append:/tmp/polaris-daemon.log
+
+[Install]
+WantedBy=default.target
+`;
+
+  await mkdir(SYSTEMD_USER_DIR, { recursive: true });
+  await writeFile(SYSTEMD_SERVICE_FILE, unit);
+
+  // Reload unit files, enable (start-at-login) and start/restart the service
+  Bun.spawnSync(["systemctl", "--user", "daemon-reload"], { stdout: "ignore", stderr: "ignore" });
+  Bun.spawnSync(["systemctl", "--user", "enable", SYSTEMD_SERVICE_NAME], { stdout: "ignore", stderr: "ignore" });
+  const start = Bun.spawnSync(["systemctl", "--user", "restart", SYSTEMD_SERVICE_NAME], { stdout: "pipe", stderr: "pipe" });
+  if (start.exitCode !== 0) {
+    console.error(`  Warning: could not start daemon service: ${start.stderr.toString().trim()}`);
+    console.error(`  Try manually: systemctl --user restart ${SYSTEMD_SERVICE_NAME}`);
+  }
+
+  // Enable lingering so the user service survives logout and starts at boot
+  // (best-effort — requires sudo-less loginctl or appropriate privileges)
+  Bun.spawnSync(["loginctl", "enable-linger"], { stdout: "ignore", stderr: "ignore" });
+}
+
+async function removeSystemdService(): Promise<void> {
+  Bun.spawnSync(["systemctl", "--user", "disable", "--now", SYSTEMD_SERVICE_NAME], { stdout: "ignore", stderr: "ignore" });
+  try { await rm(SYSTEMD_SERVICE_FILE); } catch { /* already gone */ }
+  Bun.spawnSync(["systemctl", "--user", "daemon-reload"], { stdout: "ignore", stderr: "ignore" });
+}
+
+// Platform dispatcher
+async function installDaemonService(daemonSecret?: string): Promise<void> {
+  if (process.platform === "darwin") return installLaunchAgent(daemonSecret);
+  if (process.platform === "linux") return installSystemdService(daemonSecret);
+  // Windows and others: no managed service; daemon is started manually
+}
+
+async function removeDaemonService(): Promise<void> {
+  if (process.platform === "darwin") return removeLaunchAgent();
+  if (process.platform === "linux") return removeSystemdService();
+}
+
+function daemonServiceLabel(): string {
+  if (process.platform === "darwin") return "launchd (auto-restarts on crash, starts at login)";
+  if (process.platform === "linux") return "systemd user service (auto-restarts on crash, starts at login)";
+  return "background process";
+}
+
 // --- Daemon secret ---
 
 // Shared local secret for daemon HTTP auth. Stored in ~/.polaris/config.json
@@ -272,6 +425,10 @@ Based on the arguments provided, do ONE of the following:
 1. Call \`polaris_status\`
 2. Display the current connection state
 
+### Daemon
+
+The Polaris daemon runs locally and is managed automatically — do NOT manually configure launchd or systemd. If the user reports the daemon is down or not starting at login, tell them to run \`polaris install\` which sets up auto-restart (launchd on macOS, systemd user service on Linux).
+
 ### Arguments: $ARGUMENTS
 `;
   await writeFile(join(skillDir, "SKILL.md"), skillContent);
@@ -782,6 +939,7 @@ async function recover() {
 
 async function logout(all = false) {
   if (all) {
+    await removeDaemonService();
     try {
       await rm(POLARIS_DIR, { recursive: true });
       console.log("All profiles and credentials removed.");
@@ -884,17 +1042,8 @@ 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");
+    await installDaemonService(await ensureDaemonSecret());
+    console.log(`  ✓ Daemon registered with ${daemonServiceLabel()}`);
     console.log("\nInstall complete.");
     break;
 
@@ -904,15 +1053,8 @@ switch (command) {
     console.log("Polaris — authenticating\n");
     await login(appUrl, profileName);
     console.log("\n✓ Login complete!");
-    // 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",
-      stderr: "ignore",
-      env: { ...process.env },
-    }).unref?.();
-    console.log("  ✓ Daemon started in background");
+    await installDaemonService(await ensureDaemonSecret());
+    console.log(`  ✓ Daemon registered with ${daemonServiceLabel()}`);
 
     console.log("\nNext: restart Claude Code, then run `/polaris join #channel-name` in your AI agent.");
     break;
@@ -965,15 +1107,8 @@ switch (command) {
     console.log("[2/2] Authenticating...\n");
     await login(DEFAULT_APP_URL);
     console.log("\n✓ Polaris is set up on this machine!");
-    // 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",
-      stderr: "ignore",
-      env: { ...process.env },
-    }).unref?.();
-    console.log("  ✓ Daemon started in background");
+    await installDaemonService(await ensureDaemonSecret());
+    console.log(`  ✓ Daemon registered with ${daemonServiceLabel()}`);
 
     console.log("\nNext: restart Claude Code, then run `/polaris join #channel-name` in your AI agent.");
     break;

package/src/client/client.ts

@@ -100,7 +100,9 @@ const mcp = new Server(
       experimental: { "claude/channel": {} },
       tools: {},
     },
-    instructions: `You are connected to Polaris — a multiplayer collaboration system. Messages from advisors and teammates may arrive as <channel source="polaris" from="..."> tags. Use /polaris commands to manage your session, or call the polaris tools directly.`,
+    instructions: `You are connected to Polaris — a multiplayer collaboration system. Messages from advisors and teammates may arrive as <channel source="polaris" from="..."> tags. Use /polaris commands to manage your session, or call the polaris tools directly.
+
+If the user reports the Polaris daemon is not running or keeps crashing, tell them to run \`polaris install\` — it registers the daemon with launchd on macOS or a systemd user service on Linux for auto-restart on crash and at login. Do NOT suggest manually configuring launchd or systemd — \`polaris install\` handles it.`,
   }
 );