@lightupai/polaris 0.0.97 → 0.0.99

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.97",
+  "version": "0.0.99",
   "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

@@ -47,6 +47,6 @@ Based on the arguments provided, do ONE of the following:
 
 ### Daemon
 
-The Polaris daemon runs locally and is managed automatically — do NOT suggest systemd, launchd configuration, or other process managers. 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).
+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,16 +107,13 @@ function appToApi(appUrl: string): string {
   return appUrl.replace("app.", "api.");
 }
 
-// --- LaunchAgent (macOS daemon auto-restart) ---
+// --- 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`);
 
-// Writes a runner script + launchd plist so the daemon survives crashes and
-// starts automatically at login. No-op on non-macOS platforms.
 async function installLaunchAgent(daemonSecret?: string): Promise<void> {
-  if (process.platform !== "darwin") return;
-
   const binDir = join(POLARIS_DIR, "bin");
   const runnerPath = join(binDir, "run-daemon.sh");
   const daemonTsPath = join(
@@ -175,11 +172,108 @@ async function installLaunchAgent(daemonSecret?: string): Promise<void> {
 }
 
 async function removeLaunchAgent(): Promise<void> {
-  if (process.platform !== "darwin") return;
   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> {
+  // Resolve bun's absolute path at install time so systemd's minimal PATH
+  // doesn't matter. Bun.which() searches PATH; process.execPath is the
+  // interpreter we're already running under — use whichever looks like bun.
+  const bunPath = Bun.which("bun") ?? process.execPath;
+
+  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 });
+  // Bun path is baked in at install time — no runtime search needed
+  const runner = [
+    "#!/bin/sh",
+    `# Polaris daemon — managed by systemd (${SYSTEMD_SERVICE_NAME}.service)`,
+    `# bun path resolved at install time: ${bunPath}`,
+    `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);
+
+  // Stop any existing manually-started daemon so it releases port 4322
+  // before systemd takes over
+  await killExistingDaemon();
+
+  // 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" });
+  Bun.spawnSync(["systemctl", "--user", "restart", SYSTEMD_SERVICE_NAME], { stdout: "ignore", stderr: "ignore" });
+
+  // Verify the service came up
+  const check = Bun.spawnSync(["systemctl", "--user", "is-active", SYSTEMD_SERVICE_NAME], { stdout: "pipe", stderr: "ignore" });
+  if (check.stdout.toString().trim() !== "active") {
+    console.error(`  Warning: daemon service did not start. Check logs:`);
+    const journal = Bun.spawnSync(
+      ["journalctl", "--user", "-u", SYSTEMD_SERVICE_NAME, "-n", "10", "--no-pager"],
+      { stdout: "pipe", stderr: "ignore" }
+    );
+    console.error(journal.stdout.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
@@ -347,7 +441,7 @@ Based on the arguments provided, do ONE of the following:
 
 ### Daemon
 
-The Polaris daemon runs locally and is managed automatically — do NOT suggest systemd, launchd configuration, or other process managers. 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).
+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
 `;
@@ -859,7 +953,7 @@ async function recover() {
 
 async function logout(all = false) {
   if (all) {
-    await removeLaunchAgent();
+    await removeDaemonService();
     try {
       await rm(POLARIS_DIR, { recursive: true });
       console.log("All profiles and credentials removed.");
@@ -962,8 +1056,8 @@ switch (command) {
   case "install":
     console.log("Polaris — installing local components\n");
     await install();
-    await installLaunchAgent(await ensureDaemonSecret());
-    console.log("  ✓ Daemon registered with launchd (auto-restarts on crash, starts at login)");
+    await installDaemonService(await ensureDaemonSecret());
+    console.log(`  ✓ Daemon registered with ${daemonServiceLabel()}`);
     console.log("\nInstall complete.");
     break;
 
@@ -973,8 +1067,8 @@ switch (command) {
     console.log("Polaris — authenticating\n");
     await login(appUrl, profileName);
     console.log("\n✓ Login complete!");
-    await installLaunchAgent(await ensureDaemonSecret());
-    console.log("  ✓ Daemon restarted");
+    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;
@@ -1027,8 +1121,8 @@ switch (command) {
     console.log("[2/2] Authenticating...\n");
     await login(DEFAULT_APP_URL);
     console.log("\n✓ Polaris is set up on this machine!");
-    await installLaunchAgent(await ensureDaemonSecret());
-    console.log("  ✓ Daemon registered with launchd (auto-restarts on crash, starts at login)");
+    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

@@ -102,7 +102,7 @@ const mcp = new Server(
     },
     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 (macOS) for auto-restart on crash and at login. Do NOT suggest systemd, manual launchd configuration, or other process managers.`,
+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.`,
   }
 );