alvin-bot 4.5.1 → 4.7.0

package/bin/cli.js

@@ -1153,6 +1153,232 @@ async function version() {
   }
 }
 
+// ── LaunchAgent helpers (macOS only) ────────────────────────────────────────
+
+/**
+ * Render the launchd plist that runs `node dist/index.js` as a per-user
+ * agent. Inherits the GUI login session so the macOS Keychain is
+ * automatically unlocked — which means Claude Code OAuth tokens (Max
+ * subscription) work without a manual `security unlock-keychain`.
+ */
+function renderLaunchdPlist({ label, nodePath, entryPoint, cwd, home, logDir }) {
+  // PATH covers both Apple Silicon and Intel Homebrew plus the legacy
+  // user-local claude binary path.
+  const pathValue = `${home}/.local/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin`;
+  return `<?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>${label}</string>
+
+    <key>ProgramArguments</key>
+    <array>
+        <string>${nodePath}</string>
+        <string>${entryPoint}</string>
+    </array>
+
+    <key>WorkingDirectory</key>
+    <string>${cwd}</string>
+
+    <key>RunAtLoad</key>
+    <true/>
+
+    <key>KeepAlive</key>
+    <dict>
+        <key>SuccessfulExit</key>
+        <false/>
+        <key>Crashed</key>
+        <true/>
+    </dict>
+
+    <key>ThrottleInterval</key>
+    <integer>10</integer>
+
+    <key>StandardOutPath</key>
+    <string>${logDir}/alvin-bot.out.log</string>
+
+    <key>StandardErrorPath</key>
+    <string>${logDir}/alvin-bot.err.log</string>
+
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>PATH</key>
+        <string>${pathValue}</string>
+        <key>HOME</key>
+        <string>${home}</string>
+        <key>NODE_ENV</key>
+        <string>production</string>
+    </dict>
+</dict>
+</plist>
+`;
+}
+
+/**
+ * Common paths + label used by all three launchd subcommands.
+ */
+function launchdPaths() {
+  const home = homedir();
+  const label = "com.alvinbot.app";
+  const plistPath = join(home, "Library", "LaunchAgents", `${label}.plist`);
+  const logDir = join(home, ".alvin-bot", "logs");
+  // dist/index.js lives two levels up from bin/cli.js, then dist/
+  const entryPoint = resolve(join(import.meta.dirname, "..", "dist", "index.js"));
+  const cwd = resolve(join(import.meta.dirname, ".."));
+  const nodePath = process.execPath;
+  return { home, label, plistPath, logDir, entryPoint, cwd, nodePath };
+}
+
+async function launchdInstall() {
+  if (process.platform !== "darwin") {
+    console.log("❌ alvin-bot launchd is macOS-only.");
+    console.log("   Linux users: create a systemd user unit for dist/index.js.");
+    console.log("   Windows users: use Task Scheduler or NSSM.");
+    process.exit(1);
+  }
+
+  const { home, label, plistPath, logDir, entryPoint, cwd, nodePath } = launchdPaths();
+
+  // Sanity-check that dist/ is built
+  if (!existsSync(entryPoint)) {
+    console.log(`❌ Build not found at ${entryPoint}`);
+    console.log("   Run 'npm run build' first.");
+    process.exit(1);
+  }
+
+  // Ensure the LaunchAgents dir and log dir exist
+  mkdirSync(join(home, "Library", "LaunchAgents"), { recursive: true });
+  mkdirSync(logDir, { recursive: true });
+
+  // Render and write the plist
+  const plist = renderLaunchdPlist({ label, nodePath, entryPoint, cwd, home, logDir });
+  writeFileSync(plistPath, plist, { mode: 0o644 });
+  console.log(`📝 Wrote ${plistPath}`);
+
+  // Unload any previous instance (best-effort)
+  try {
+    execSync(`launchctl unload -w "${plistPath}"`, { stdio: "pipe" });
+  } catch { /* not loaded yet — fine */ }
+
+  // Stop any nohup'd bot that might still be running
+  try {
+    execSync(`pkill -TERM -f 'node.*dist/index.js' || true`, { stdio: "pipe" });
+  } catch { /* nothing to kill */ }
+
+  // Load fresh
+  try {
+    execSync(`launchctl load -w "${plistPath}"`, { stdio: "inherit" });
+  } catch (err) {
+    console.log(`❌ launchctl load failed: ${err.message}`);
+    console.log("   Try manually: launchctl load -w " + plistPath);
+    process.exit(1);
+  }
+
+  console.log("");
+  console.log("✅ alvin-bot is now a launchd user agent.");
+  console.log(`   Label:   ${label}`);
+  console.log(`   Logs:    ${logDir}/alvin-bot.out.log`);
+  console.log(`   Errors:  ${logDir}/alvin-bot.err.log`);
+  console.log("");
+  console.log("   Status:    alvin-bot launchd status");
+  console.log("   Stop:      alvin-bot launchd uninstall");
+  console.log("   Restart:   launchctl kickstart -k gui/$UID/" + label);
+  console.log("");
+  console.log("   Because launchd runs the bot inside your GUI login session,");
+  console.log("   the macOS Keychain is automatically unlocked — Claude Code");
+  console.log("   OAuth tokens (Max subscription) just work, no SSH keychain");
+  console.log("   dance needed anymore.");
+  process.exit(0);
+}
+
+async function launchdUninstall() {
+  if (process.platform !== "darwin") {
+    console.log("❌ alvin-bot launchd is macOS-only.");
+    process.exit(1);
+  }
+  const { plistPath, label } = launchdPaths();
+  if (!existsSync(plistPath)) {
+    console.log(`⚠️  No LaunchAgent plist at ${plistPath}`);
+    console.log("   Nothing to uninstall.");
+    process.exit(0);
+  }
+
+  try {
+    execSync(`launchctl unload -w "${plistPath}"`, { stdio: "inherit" });
+    console.log(`✅ Unloaded ${label}`);
+  } catch (err) {
+    console.log(`⚠️  Unload reported an error (may not have been running): ${err.message}`);
+  }
+
+  try {
+    execSync(`rm -f "${plistPath}"`);
+    console.log(`🗑  Removed ${plistPath}`);
+  } catch (err) {
+    console.log(`⚠️  Could not remove plist: ${err.message}`);
+  }
+
+  console.log("");
+  console.log("✅ alvin-bot is no longer a launchd user agent.");
+  process.exit(0);
+}
+
+async function launchdStatus() {
+  if (process.platform !== "darwin") {
+    console.log("❌ alvin-bot launchd is macOS-only.");
+    process.exit(1);
+  }
+  const { plistPath, label, logDir } = launchdPaths();
+
+  console.log(`📋 alvin-bot launchd status`);
+  console.log("");
+  console.log(`Label:    ${label}`);
+  console.log(`Plist:    ${plistPath}`);
+  console.log(`Plist exists: ${existsSync(plistPath) ? "yes" : "no"}`);
+  console.log("");
+
+  try {
+    const out = execSync(`launchctl list | grep ${label} || true`, { encoding: "utf-8" });
+    if (out.trim()) {
+      // Format: <PID>\t<ExitCode>\t<Label>
+      const parts = out.trim().split(/\s+/);
+      const pid = parts[0];
+      const exitCode = parts[1];
+      const isRunning = pid !== "-" && pid !== "0";
+      console.log(`Running:  ${isRunning ? "✅ yes (PID " + pid + ")" : "❌ no (last exit " + exitCode + ")"}`);
+    } else {
+      console.log(`Running:  ❌ not loaded`);
+    }
+  } catch {
+    console.log(`Running:  ❌ unknown (launchctl list failed)`);
+  }
+
+  console.log("");
+  console.log(`Log dir:  ${logDir}`);
+  const outLog = join(logDir, "alvin-bot.out.log");
+  const errLog = join(logDir, "alvin-bot.err.log");
+  if (existsSync(outLog)) {
+    try {
+      const tail = execSync(`tail -n 5 "${outLog}"`, { encoding: "utf-8" });
+      console.log("");
+      console.log("── Last 5 lines of stdout ──");
+      console.log(tail.trimEnd());
+    } catch { /* ignore */ }
+  }
+  if (existsSync(errLog)) {
+    try {
+      const tail = execSync(`tail -n 5 "${errLog}"`, { encoding: "utf-8" });
+      const trimmed = tail.trimEnd();
+      if (trimmed) {
+        console.log("");
+        console.log("── Last 5 lines of stderr ──");
+        console.log(trimmed);
+      }
+    } catch { /* ignore */ }
+  }
+  process.exit(0);
+}
+
 // ── CLI Router ──────────────────────────────────────────────────────────────
 
 const cmd = process.argv[2];
@@ -1170,40 +1396,93 @@ switch (cmd) {
     const fg = process.argv.includes("--foreground") || process.argv.includes("-f");
     if (fg) {
       import("../dist/index.js");
-    } else {
-      // Start via PM2 (background, survives terminal close, auto-restart on crash)
-      try {
-        execSync("pm2 --version", { stdio: "pipe" });
-      } catch {
-        // PM2 not installed — install it
-        console.log("Installing PM2 for background operation...");
+      break;
+    }
+
+    // On macOS, if a LaunchAgent plist already exists, we're in "launchd
+    // mode" — don't start pm2 in parallel. Reload the LaunchAgent instead
+    // so a plain `alvin-bot start` still works as "bring the bot up".
+    if (process.platform === "darwin") {
+      const { plistPath, label } = launchdPaths();
+      if (existsSync(plistPath)) {
+        console.log(`🚀 Detected existing LaunchAgent (${label})`);
+        console.log(`   Reloading via 'launchctl kickstart -k'...`);
         try {
-          execSync("npm install -g pm2", { stdio: "inherit", timeout: 60000 });
+          execSync(`launchctl kickstart -k gui/$(id -u)/${label}`, {
+            stdio: "inherit",
+            shell: "/bin/zsh",
+          });
         } catch {
-          console.log("Could not install PM2. Starting in foreground instead.");
-          console.log("Tip: Install PM2 manually (npm install -g pm2) to run in background.\n");
-          await import("../dist/index.js");
-          break;
+          // Maybe unloaded — load it fresh
+          try {
+            execSync(`launchctl load -w "${plistPath}"`, { stdio: "inherit" });
+          } catch (err) {
+            console.log(`❌ launchctl load failed: ${err.message}`);
+            process.exit(1);
+          }
         }
+        console.log("\n✅ Bot is running via launchd.");
+        console.log("   Status: alvin-bot launchd status");
+        console.log("   Stop:   alvin-bot stop");
+        console.log("   Logs:   ~/.alvin-bot/logs/alvin-bot.out.log");
+        process.exit(0);
       }
-      const cliPath = resolve(join(import.meta.dirname, "cli.js"));
+    }
+
+    // Fall-through: pm2 path (Linux, Windows, or macOS without LaunchAgent)
+    try {
+      execSync("pm2 --version", { stdio: "pipe" });
+    } catch {
+      console.log("Installing PM2 for background operation...");
       try {
-        // Stop existing instance if running
-        execSync("pm2 delete alvin-bot", { stdio: "pipe" });
-      } catch { /* not running — fine */ }
-      execSync(`pm2 start "${cliPath}" --name alvin-bot -- start --foreground`, {
-        stdio: "inherit",
-        timeout: 15000,
-      });
-      console.log("\n✅ Bot is running in the background.");
-      console.log("   Logs:    pm2 logs alvin-bot");
-      console.log("   Stop:    alvin-bot stop");
-      console.log("   Restart: alvin-bot start\n");
-      process.exit(0);
+        execSync("npm install -g pm2", { stdio: "inherit", timeout: 60000 });
+      } catch {
+        console.log("Could not install PM2. Starting in foreground instead.");
+        console.log("Tip: Install PM2 manually (npm install -g pm2) to run in background.\n");
+        await import("../dist/index.js");
+        break;
+      }
     }
-    break;
+    const cliPath = resolve(join(import.meta.dirname, "cli.js"));
+    try {
+      execSync("pm2 delete alvin-bot", { stdio: "pipe" });
+    } catch { /* not running — fine */ }
+    execSync(`pm2 start "${cliPath}" --name alvin-bot -- start --foreground`, {
+      stdio: "inherit",
+      timeout: 15000,
+    });
+    console.log("\n✅ Bot is running in the background via PM2.");
+    console.log("   Logs:    pm2 logs alvin-bot");
+    console.log("   Stop:    alvin-bot stop");
+    console.log("   Restart: alvin-bot start");
+    if (process.platform === "darwin") {
+      console.log("");
+      console.log("   💡 Tip: on macOS with Claude Code, switch to launchd for");
+      console.log("      automatic Keychain access:  alvin-bot launchd install");
+    }
+    console.log("");
+    process.exit(0);
   }
   case "stop": {
+    // On macOS with a LaunchAgent, stopping means unloading the LaunchAgent,
+    // not asking pm2 to stop a process it never managed.
+    if (process.platform === "darwin") {
+      const { plistPath, label } = launchdPaths();
+      if (existsSync(plistPath)) {
+        console.log(`⏹  Stopping LaunchAgent (${label})...`);
+        try {
+          execSync(`launchctl unload -w "${plistPath}"`, { stdio: "inherit" });
+          console.log("✅ LaunchAgent stopped.");
+          console.log("   (The plist is still installed. To remove it: alvin-bot launchd uninstall)");
+        } catch (err) {
+          console.log(`❌ launchctl unload failed: ${err.message}`);
+          process.exit(1);
+        }
+        process.exit(0);
+      }
+    }
+
+    // Fall-through: pm2 path
     try {
       execSync("pm2 stop alvin-bot", { stdio: "inherit", timeout: 10000 });
     } catch {
@@ -1211,6 +1490,25 @@ switch (cmd) {
     }
     process.exit(0);
   }
+  case "launchd": {
+    const sub = process.argv[3];
+    if (sub === "install") {
+      await launchdInstall();
+    } else if (sub === "uninstall") {
+      await launchdUninstall();
+    } else if (sub === "status") {
+      await launchdStatus();
+    } else {
+      console.log("Usage: alvin-bot launchd <install|uninstall|status>");
+      console.log("");
+      console.log("  install    — Install as a macOS launchd user agent.");
+      console.log("               Runs on login, keychain auto-unlocked.");
+      console.log("  uninstall  — Unload and remove the LaunchAgent plist.");
+      console.log("  status     — Show current launchd state + recent logs.");
+      process.exit(1);
+    }
+    break;
+  }
   case "tui":
   case "chat":
     import("../dist/tui/index.js").then(m => m.startTUI()).catch(console.error);
@@ -1254,6 +1552,7 @@ ${t("cli.commands")}
   start     ${t("cli.startDesc")} (background via PM2)
   start -f  Start in foreground (for debugging)
   stop      Stop the bot
+  launchd   macOS only: install/uninstall/status as launchd user agent
   version   ${t("cli.versionDesc")}
 
 ${t("cli.example")}