@rethinkingstudio/clawpilot 2.0.0-beta.0 → 2.0.0

package/src/platform/service-manager.ts

@@ -1,919 +0,0 @@
-import { existsSync, mkdirSync, openSync, readFileSync, realpathSync, unlinkSync, writeFileSync } from "fs";
-import { execSync, spawn } from "child_process";
-import { homedir, userInfo } from "os";
-import { dirname, join, resolve } from "path";
-import { createRequire } from "module";
-import { fileURLToPath } from "url";
-
-export type ServicePlatform = "macos" | "linux" | "windows" | "unsupported";
-
-export interface ServiceStatus {
-  platform: ServicePlatform;
-  installed: boolean;
-  running: boolean;
-  serviceName: string;
-  manager: string;
-  servicePath?: string;
-  logPath: string;
-  startHint?: string;
-  autoStartHint?: string;
-}
-
-const MAC_LABEL = "com.rethinkingstudio.clawpilot";
-const MAC_LABEL_OLD = "com.rethinkingstudio.clawai";
-const MAC_PLIST_DIR = join(homedir(), "Library", "LaunchAgents");
-const MAC_PLIST_PATH = join(MAC_PLIST_DIR, `${MAC_LABEL}.plist`);
-const MAC_PLIST_PATH_OLD = join(MAC_PLIST_DIR, `${MAC_LABEL_OLD}.plist`);
-
-const LINUX_SERVICE_NAME = "clawpilot.service";
-const LINUX_SYSTEMD_USER_DIR = join(homedir(), ".config", "systemd", "user");
-const LINUX_SERVICE_PATH = join(LINUX_SYSTEMD_USER_DIR, LINUX_SERVICE_NAME);
-
-const LOG_DIR = join(homedir(), ".clawai");
-const LOG_PATH = join(LOG_DIR, "clawpilot.log");
-const ERROR_LOG_PATH = join(LOG_DIR, "clawpilot-error.log");
-const LINUX_NOHUP_PID_PATH = join(LOG_DIR, "clawpilot.pid");
-const LINUX_NOHUP_START_SCRIPT_PATH = join(LOG_DIR, "clawpilot-start.sh");
-const WINDOWS_PID_PATH = join(LOG_DIR, "clawpilot-windows.pid");
-const WINDOWS_START_SCRIPT_PATH = join(LOG_DIR, "clawpilot-start.cmd");
-const WINDOWS_TASK_NAME = "ClawPilot Relay Client";
-const PM2_PROCESS_NAME = "clawpilot";
-
-const require = createRequire(import.meta.url);
-const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
-const PACKAGE_ROOT = resolve(MODULE_DIR, "..", "..");
-
-function detectPlatform(): ServicePlatform {
-  if (process.platform === "darwin") return "macos";
-  if (process.platform === "linux") return "linux";
-  if (process.platform === "win32") return "windows";
-  return "unsupported";
-}
-
-function shellEscape(arg: string): string {
-  return `'${arg.replace(/'/g, `'\\''`)}'`;
-}
-
-function run(command: string, stdio: "pipe" | "inherit" = "pipe"): void {
-  execSync(command, { stdio });
-}
-
-function runOutput(command: string): string {
-  return execSync(command, { stdio: ["pipe", "pipe", "pipe"], encoding: "utf-8" }).trim();
-}
-
-function runResult(command: string): { ok: boolean; output: string } {
-  try {
-    return {
-      ok: true,
-      output: execSync(command, { stdio: ["pipe", "pipe", "pipe"], encoding: "utf-8" }).trim(),
-    };
-  } catch (error) {
-    const output = error instanceof Error && "stdout" in error
-      ? `${String((error as { stdout?: string }).stdout ?? "")}\n${String((error as { stderr?: string }).stderr ?? "")}`.trim()
-      : "";
-    return { ok: false, output };
-  }
-}
-
-function commandExists(command: string): boolean {
-  try {
-    if (process.platform === "win32") {
-      run(`where ${command}`, "pipe");
-    } else {
-      run(`command -v ${command}`, "pipe");
-    }
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function getProgramArgs(): string[] {
-  const nodeBin = process.execPath;
-  const scriptPath = process.argv[1];
-  return nodeBin === scriptPath ? [scriptPath, "run"] : [nodeBin, scriptPath, "run"];
-}
-
-function ensureLogDir(): void {
-  mkdirSync(LOG_DIR, { recursive: true });
-}
-
-function canUseSystemdUser(): boolean {
-  if (!commandExists("systemctl")) return false;
-  try {
-    run("systemctl --user show-environment", "pipe");
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function getLinuxLingerHint(): string | undefined {
-  if (process.platform !== "linux" || !commandExists("loginctl")) return undefined;
-  try {
-    const value = runOutput(`loginctl show-user ${shellEscape(userInfo().username)} -p Linger --value`);
-    if (value.toLowerCase() === "yes") return undefined;
-  } catch {
-    return undefined;
-  }
-  return `sudo loginctl enable-linger ${userInfo().username}`;
-}
-
-function isPidRunning(pid: number): boolean {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function readNohupPid(): number | null {
-  return readPidFile(LINUX_NOHUP_PID_PATH);
-}
-
-function readWindowsPid(): number | null {
-  return readPidFile(WINDOWS_PID_PATH);
-}
-
-function readPidFile(path: string): number | null {
-  if (!existsSync(path)) return null;
-  try {
-    const raw = readFileSync(path, "utf-8").trim();
-    const pid = Number(raw);
-    return Number.isInteger(pid) && pid > 0 ? pid : null;
-  } catch {
-    return null;
-  }
-}
-
-function removeNohupPidFile(): void {
-  removePidFile(LINUX_NOHUP_PID_PATH);
-}
-
-function removeWindowsPidFile(): void {
-  removePidFile(WINDOWS_PID_PATH);
-}
-
-function removePidFile(path: string): void {
-  if (existsSync(path)) {
-    unlinkSync(path);
-  }
-}
-
-function getNohupStartCommand(): string {
-  return `bash ${shellEscape(LINUX_NOHUP_START_SCRIPT_PATH)}`;
-}
-
-function writeLinuxNohupStartScript(): void {
-  const args = getProgramArgs().map(shellEscape).join(" ");
-  const script = `#!/usr/bin/env bash
-set -euo pipefail
-
-mkdir -p ${shellEscape(LOG_DIR)}
-if [ -f ${shellEscape(LINUX_NOHUP_PID_PATH)} ]; then
-  pid="$(cat ${shellEscape(LINUX_NOHUP_PID_PATH)} 2>/dev/null || true)"
-  if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then
-    echo "clawpilot is already running (pid=$pid)"
-    exit 0
-  fi
-fi
-
-nohup ${args} >> ${shellEscape(LOG_PATH)} 2>> ${shellEscape(ERROR_LOG_PATH)} < /dev/null &
-echo $! > ${shellEscape(LINUX_NOHUP_PID_PATH)}
-echo "clawpilot started in nohup mode (pid=$(cat ${shellEscape(LINUX_NOHUP_PID_PATH)}))"
-`;
-  writeFileSync(LINUX_NOHUP_START_SCRIPT_PATH, script, { encoding: "utf-8", mode: 0o755 });
-}
-
-function writeWindowsStartScript(): void {
-  const args = getProgramArgs()
-    .map((arg) => `"${arg.replace(/"/g, '""')}"`)
-    .join(" ");
-  const script = `@echo off
-setlocal
-if not exist "${LOG_DIR}" mkdir "${LOG_DIR}"
-${args} >> "${LOG_PATH}" 2>> "${ERROR_LOG_PATH}"
-`;
-  writeFileSync(WINDOWS_START_SCRIPT_PATH, script, "utf-8");
-}
-
-function installMacService(): boolean {
-  const argsXml = getProgramArgs().map((arg) => `    <string>${arg}</string>`).join("\n");
-  const plistContent = `<?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>${MAC_LABEL}</string>
-  <key>ProgramArguments</key>
-  <array>
-${argsXml}
-  </array>
-  <key>RunAtLoad</key>
-  <true/>
-  <key>KeepAlive</key>
-  <true/>
-  <key>StandardOutPath</key>
-  <string>${LOG_PATH}</string>
-  <key>StandardErrorPath</key>
-  <string>${ERROR_LOG_PATH}</string>
-</dict>
-</plist>`;
-
-  mkdirSync(MAC_PLIST_DIR, { recursive: true });
-  ensureLogDir();
-
-  try {
-    run(`launchctl unload -w "${MAC_PLIST_PATH}"`);
-  } catch {
-    // Ignore if not loaded.
-  }
-
-  writeFileSync(MAC_PLIST_PATH, plistContent, "utf-8");
-
-  try {
-    run(`launchctl load -w "${MAC_PLIST_PATH}"`, "inherit");
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function installLinuxServiceSystemd(): boolean {
-  mkdirSync(LINUX_SYSTEMD_USER_DIR, { recursive: true });
-  ensureLogDir();
-
-  const args = getProgramArgs().map(shellEscape).join(" ");
-  const serviceContent = `[Unit]
-Description=ClawPilot relay client
-After=network-online.target
-Wants=network-online.target
-
-[Service]
-Type=simple
-ExecStart=${args}
-Restart=always
-RestartSec=5
-WorkingDirectory=${shellEscape(process.cwd())}
-StandardOutput=append:${LOG_PATH}
-StandardError=append:${ERROR_LOG_PATH}
-
-[Install]
-WantedBy=default.target
-`;
-
-  writeFileSync(LINUX_SERVICE_PATH, serviceContent, "utf-8");
-  run("systemctl --user daemon-reload", "inherit");
-  run(`systemctl --user enable --now ${LINUX_SERVICE_NAME}`, "inherit");
-  return true;
-}
-
-function installLinuxServiceNohup(): boolean {
-  ensureLogDir();
-  writeLinuxNohupStartScript();
-  run(`sh -lc ${shellEscape(getNohupStartCommand())}`, "inherit");
-  const pid = readNohupPid();
-  return pid != null && isPidRunning(pid);
-}
-
-function installLinuxService(): boolean {
-  if (isGlobalInstall() && canUsePm2()) {
-    try {
-      return installPm2Service();
-    } catch {
-      // Fall through to legacy modes below.
-    }
-  }
-
-  if (canUseSystemdUser()) {
-    try {
-      uninstallLinuxArtifacts(false);
-      return installLinuxServiceSystemd();
-    } catch {
-      // Fall through to nohup below.
-    }
-  }
-
-  try {
-    return installLinuxServiceNohup();
-  } catch {
-    return false;
-  }
-}
-
-function canUseWindowsTaskScheduler(): boolean {
-  return process.platform === "win32" && commandExists("schtasks");
-}
-
-function getGlobalNodeModulesRoot(): string | null {
-  const npmCommand = process.platform === "win32" ? "npm.cmd" : "npm";
-  try {
-    return realpathSync(runOutput(`${npmCommand} root -g`));
-  } catch {
-    return null;
-  }
-}
-
-function isGlobalInstall(): boolean {
-  const globalRoot = getGlobalNodeModulesRoot();
-  if (!globalRoot) return false;
-  try {
-    const packageRoot = realpathSync(PACKAGE_ROOT);
-    return packageRoot === globalRoot || packageRoot.startsWith(`${globalRoot}${process.platform === "win32" ? "\\" : "/"}`);
-  } catch {
-    return false;
-  }
-}
-
-function resolvePm2CliPath(): string | null {
-  try {
-    return require.resolve("pm2/bin/pm2");
-  } catch {
-    return null;
-  }
-}
-
-function canUsePm2(): boolean {
-  return resolvePm2CliPath() != null;
-}
-
-function getPm2StartupHint(): string {
-  return "pm2 startup && pm2 save";
-}
-
-function runPm2(args: string[]): { ok: boolean; output: string } {
-  const cliPath = resolvePm2CliPath();
-  if (!cliPath) {
-    return { ok: false, output: "pm2 cli not found" };
-  }
-  const command = `${shellEscape(process.execPath)} ${shellEscape(cliPath)} ${args.map(shellEscape).join(" ")}`;
-  return runResult(command);
-}
-
-function isPm2ProcessInstalled(): boolean {
-  const result = runPm2(["describe", PM2_PROCESS_NAME]);
-  return result.ok;
-}
-
-function isPm2ProcessRunning(): boolean {
-  const result = runPm2(["jlist"]);
-  if (!result.ok || !result.output) return false;
-  try {
-    const processes = JSON.parse(result.output) as Array<{ name?: string; pm2_env?: { status?: string } }>;
-    return processes.some((entry) => entry.name === PM2_PROCESS_NAME && entry.pm2_env?.status === "online");
-  } catch {
-    return false;
-  }
-}
-
-function installPm2Service(): boolean {
-  if (isPm2ProcessInstalled()) {
-    const restarted = restartPm2Service();
-    if (restarted) {
-      runPm2(["save"]);
-      runPm2(["startup"]);
-    }
-    return restarted;
-  }
-
-  const args = getProgramArgs();
-  const start = runPm2([
-    "start",
-    args[0],
-    "--name",
-    PM2_PROCESS_NAME,
-    "--time",
-    "--output",
-    LOG_PATH,
-    "--error",
-    ERROR_LOG_PATH,
-    "--",
-    ...args.slice(1),
-  ]);
-  if (!start.ok) return false;
-  runPm2(["save"]);
-  runPm2(["startup"]);
-  return isPm2ProcessInstalled();
-}
-
-function restartPm2Service(): boolean {
-  if (!isPm2ProcessInstalled()) return false;
-  const result = runPm2(["restart", PM2_PROCESS_NAME]);
-  return result.ok;
-}
-
-function stopPm2Service(removeProcess: boolean): boolean {
-  if (!isPm2ProcessInstalled()) return false;
-  const command = removeProcess ? "delete" : "stop";
-  const result = runPm2([command, PM2_PROCESS_NAME]);
-  if (removeProcess) {
-    runPm2(["save"]);
-  }
-  return result.ok;
-}
-
-function isWindowsTaskInstalled(): boolean {
-  if (!canUseWindowsTaskScheduler()) return false;
-  try {
-    run(`schtasks /Query /TN "${WINDOWS_TASK_NAME}"`, "pipe");
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function isWindowsTaskRunning(): boolean {
-  if (!isWindowsTaskInstalled() || !commandExists("powershell")) return false;
-  try {
-    const state = runOutput(
-      `powershell -NoProfile -Command "(Get-ScheduledTask -TaskName '${WINDOWS_TASK_NAME.replace(/'/g, "''")}').State"`
-    );
-    return state.toLowerCase().includes("running");
-  } catch {
-    return false;
-  }
-}
-
-function installWindowsTaskScheduler(): boolean {
-  ensureLogDir();
-  writeWindowsStartScript();
-  uninstallWindowsArtifacts(false);
-  const taskCommand = `"${WINDOWS_START_SCRIPT_PATH.replace(/"/g, '""')}"`;
-  run(
-    `schtasks /Create /TN "${WINDOWS_TASK_NAME}" /SC ONLOGON /RL LIMITED /TR ${taskCommand} /F`,
-    "inherit"
-  );
-  try {
-    run(`schtasks /Run /TN "${WINDOWS_TASK_NAME}"`, "inherit");
-  } catch {
-    // Best effort: task is installed even if immediate start fails.
-  }
-  return isWindowsTaskInstalled();
-}
-
-function installWindowsDetachedService(): boolean {
-  ensureLogDir();
-
-  const pid = readWindowsPid();
-  if (pid != null && isPidRunning(pid)) {
-    return true;
-  }
-  if (pid != null) {
-    removeWindowsPidFile();
-  }
-
-  const args = getProgramArgs();
-  const stdoutFd = openSync(LOG_PATH, "a");
-  const stderrFd = openSync(ERROR_LOG_PATH, "a");
-  const child = spawn(args[0], args.slice(1), {
-    detached: true,
-    stdio: ["ignore", stdoutFd, stderrFd],
-    windowsHide: true,
-  });
-
-  child.unref();
-  writeFileSync(WINDOWS_PID_PATH, `${child.pid}`, "utf-8");
-  return isPidRunning(child.pid ?? -1);
-}
-
-function installWindowsService(): boolean {
-  if (isGlobalInstall() && canUsePm2()) {
-    try {
-      return installPm2Service();
-    } catch {
-      // Fall back to legacy modes below.
-    }
-  }
-
-  if (canUseWindowsTaskScheduler()) {
-    try {
-      return installWindowsTaskScheduler();
-    } catch {
-      // Fall back to legacy detached mode below.
-    }
-  }
-
-  return installWindowsDetachedService();
-}
-
-function uninstallMacArtifacts(): boolean {
-  let changed = false;
-  try {
-    run(`launchctl unload -w "${MAC_PLIST_PATH}"`);
-    changed = true;
-  } catch {
-    // ignore
-  }
-  if (existsSync(MAC_PLIST_PATH)) {
-    unlinkSync(MAC_PLIST_PATH);
-    changed = true;
-  }
-  try {
-    run(`launchctl unload -w "${MAC_PLIST_PATH_OLD}"`);
-    changed = true;
-  } catch {
-    // ignore
-  }
-  if (existsSync(MAC_PLIST_PATH_OLD)) {
-    unlinkSync(MAC_PLIST_PATH_OLD);
-    changed = true;
-  }
-  return changed;
-}
-
-function uninstallLinuxArtifacts(removeFile: boolean): boolean {
-  let changed = false;
-
-  if (canUseSystemdUser()) {
-    try {
-      run(`systemctl --user stop ${LINUX_SERVICE_NAME}`);
-      changed = true;
-    } catch {
-      // ignore
-    }
-    try {
-      run(`systemctl --user disable ${LINUX_SERVICE_NAME}`);
-      changed = true;
-    } catch {
-      // ignore
-    }
-    try {
-      run("systemctl --user daemon-reload");
-    } catch {
-      // ignore
-    }
-  }
-
-  const nohupPid = readNohupPid();
-  if (nohupPid != null) {
-    try {
-      process.kill(nohupPid, "SIGTERM");
-      changed = true;
-    } catch {
-      // ignore
-    }
-    removeNohupPidFile();
-    changed = true;
-  }
-
-  if (removeFile && existsSync(LINUX_SERVICE_PATH)) {
-    unlinkSync(LINUX_SERVICE_PATH);
-    changed = true;
-  }
-  if (removeFile && existsSync(LINUX_NOHUP_START_SCRIPT_PATH)) {
-    unlinkSync(LINUX_NOHUP_START_SCRIPT_PATH);
-    changed = true;
-  }
-
-  return changed;
-}
-
-function restartMacService(): boolean {
-  return installMacService();
-}
-
-function restartLinuxService(): boolean {
-  if (isPm2ProcessInstalled()) {
-    try {
-      return restartPm2Service();
-    } catch {
-      // Fall through to legacy restart below.
-    }
-  }
-
-  if (canUseSystemdUser() && existsSync(LINUX_SERVICE_PATH)) {
-    try {
-      run("systemctl --user daemon-reload", "inherit");
-      run(`systemctl --user restart ${LINUX_SERVICE_NAME}`, "inherit");
-      return true;
-    } catch {
-      // Fall back to nohup restart below.
-    }
-  }
-
-  uninstallLinuxArtifacts(false);
-  try {
-    return installLinuxServiceNohup();
-  } catch {
-    return false;
-  }
-}
-
-function restartWindowsService(): boolean {
-  if (isPm2ProcessInstalled()) {
-    try {
-      return restartPm2Service();
-    } catch {
-      // Fall through to legacy restart below.
-    }
-  }
-
-  if (isWindowsTaskInstalled()) {
-    try {
-      run(`schtasks /End /TN "${WINDOWS_TASK_NAME}"`, "inherit");
-    } catch {
-      // ignore if not running
-    }
-    try {
-      run(`schtasks /Run /TN "${WINDOWS_TASK_NAME}"`, "inherit");
-      return true;
-    } catch {
-      return false;
-    }
-  }
-
-  uninstallWindowsArtifacts(false);
-  try {
-    return installWindowsDetachedService();
-  } catch {
-    return false;
-  }
-}
-
-function uninstallWindowsArtifacts(removeFile: boolean): boolean {
-  let changed = false;
-  if (isWindowsTaskInstalled()) {
-    try {
-      run(`schtasks /End /TN "${WINDOWS_TASK_NAME}"`, "pipe");
-      changed = true;
-    } catch {
-      // ignore if not running
-    }
-    if (removeFile) {
-      try {
-        run(`schtasks /Delete /TN "${WINDOWS_TASK_NAME}" /F`, "pipe");
-        changed = true;
-      } catch {
-        // ignore
-      }
-    }
-  }
-  const pid = readWindowsPid();
-  if (pid != null) {
-    try {
-      process.kill(pid, "SIGTERM");
-      changed = true;
-    } catch {
-      // ignore
-    }
-    removeWindowsPidFile();
-    changed = true;
-  }
-
-  if (removeFile && existsSync(WINDOWS_PID_PATH)) {
-    unlinkSync(WINDOWS_PID_PATH);
-    changed = true;
-  }
-  if (removeFile && existsSync(WINDOWS_START_SCRIPT_PATH)) {
-    unlinkSync(WINDOWS_START_SCRIPT_PATH);
-    changed = true;
-  }
-
-  return changed;
-}
-
-export function getServicePlatform(): ServicePlatform {
-  return detectPlatform();
-}
-
-export function installService(): boolean {
-  switch (detectPlatform()) {
-    case "macos":
-      return installMacService();
-    case "linux":
-      return installLinuxService();
-    case "windows":
-      return installWindowsService();
-    default:
-      return false;
-  }
-}
-
-export function restartService(): boolean {
-  switch (detectPlatform()) {
-    case "macos":
-      return restartMacService();
-    case "linux":
-      return restartLinuxService();
-    case "windows":
-      return restartWindowsService();
-    default:
-      return false;
-  }
-}
-
-export function stopService(): boolean {
-  switch (detectPlatform()) {
-    case "macos":
-      return uninstallMacArtifacts();
-    case "linux":
-      if (isPm2ProcessInstalled()) return stopPm2Service(false);
-      return uninstallLinuxArtifacts(false);
-    case "windows":
-      if (isPm2ProcessInstalled()) return stopPm2Service(false);
-      return uninstallWindowsArtifacts(false);
-    default:
-      return false;
-  }
-}
-
-export function uninstallService(): boolean {
-  switch (detectPlatform()) {
-    case "macos":
-      return uninstallMacArtifacts();
-    case "linux":
-      if (isPm2ProcessInstalled()) return stopPm2Service(true);
-      return uninstallLinuxArtifacts(true);
-    case "windows":
-      if (isPm2ProcessInstalled()) return stopPm2Service(true);
-      return uninstallWindowsArtifacts(true);
-    default:
-      return false;
-  }
-}
-
-export function getServiceStatus(): ServiceStatus {
-  const platform = detectPlatform();
-
-  if (platform === "macos") {
-    let running = false;
-    try {
-      run(`launchctl list ${MAC_LABEL}`);
-      running = true;
-    } catch {
-      running = false;
-    }
-    return {
-      platform,
-      installed: existsSync(MAC_PLIST_PATH),
-      running,
-      serviceName: MAC_LABEL,
-      manager: "launchd",
-      servicePath: MAC_PLIST_PATH,
-      logPath: LOG_PATH,
-      startHint: `launchctl start ${MAC_LABEL}`,
-    };
-  }
-
-  if (platform === "linux") {
-    if (isPm2ProcessInstalled()) {
-      return {
-        platform,
-        installed: true,
-        running: isPm2ProcessRunning(),
-        serviceName: PM2_PROCESS_NAME,
-        manager: "pm2",
-        servicePath: resolvePm2CliPath() ?? undefined,
-        logPath: LOG_PATH,
-        startHint: `pm2 start ${PM2_PROCESS_NAME}`,
-        autoStartHint: getPm2StartupHint(),
-      };
-    }
-
-    const hasSystemdServiceFile = existsSync(LINUX_SERVICE_PATH);
-    if (hasSystemdServiceFile && canUseSystemdUser()) {
-      let systemdRunning = false;
-      try {
-        run(`systemctl --user is-active --quiet ${LINUX_SERVICE_NAME}`);
-        systemdRunning = true;
-      } catch {
-        systemdRunning = false;
-      }
-      return {
-        platform,
-        installed: true,
-        running: systemdRunning,
-        serviceName: LINUX_SERVICE_NAME,
-        manager: "systemd",
-        servicePath: LINUX_SERVICE_PATH,
-        logPath: LOG_PATH,
-        startHint: `systemctl --user start ${LINUX_SERVICE_NAME}`,
-        autoStartHint: getLinuxLingerHint(),
-      };
-    }
-
-    const pid = readNohupPid();
-    const hasNohupArtifacts = pid != null || existsSync(LINUX_NOHUP_START_SCRIPT_PATH);
-    const running = pid != null && isPidRunning(pid);
-    if (!running && pid != null) {
-      removeNohupPidFile();
-    }
-
-    if (running || hasNohupArtifacts) {
-      return {
-        platform,
-        installed: hasNohupArtifacts,
-        running,
-        serviceName: "clawpilot (nohup)",
-        manager: "nohup",
-        servicePath: existsSync(LINUX_NOHUP_START_SCRIPT_PATH) ? LINUX_NOHUP_START_SCRIPT_PATH : undefined,
-        logPath: LOG_PATH,
-        startHint: getNohupStartCommand(),
-      };
-    }
-
-    return {
-      platform,
-      installed: hasSystemdServiceFile,
-      running: false,
-      serviceName: LINUX_SERVICE_NAME,
-      manager: hasSystemdServiceFile ? "systemd" : "nohup",
-      servicePath: hasSystemdServiceFile ? LINUX_SERVICE_PATH : undefined,
-      logPath: LOG_PATH,
-      startHint: hasSystemdServiceFile ? `systemctl --user start ${LINUX_SERVICE_NAME}` : undefined,
-      autoStartHint: hasSystemdServiceFile ? getLinuxLingerHint() : undefined,
-    };
-  }
-
-  if (platform === "windows") {
-    if (isPm2ProcessInstalled()) {
-      return {
-        platform,
-        installed: true,
-        running: isPm2ProcessRunning(),
-        serviceName: PM2_PROCESS_NAME,
-        manager: "pm2",
-        servicePath: resolvePm2CliPath() ?? undefined,
-        logPath: LOG_PATH,
-        startHint: `pm2 restart ${PM2_PROCESS_NAME}`,
-        autoStartHint: getPm2StartupHint(),
-      };
-    }
-
-    if (isWindowsTaskInstalled()) {
-      return {
-        platform,
-        installed: true,
-        running: isWindowsTaskRunning(),
-        serviceName: WINDOWS_TASK_NAME,
-        manager: "task-scheduler",
-        servicePath: existsSync(WINDOWS_START_SCRIPT_PATH) ? WINDOWS_START_SCRIPT_PATH : undefined,
-        logPath: LOG_PATH,
-        startHint: `schtasks /Run /TN "${WINDOWS_TASK_NAME}"`,
-      };
-    }
-
-    const pid = readWindowsPid();
-    const running = pid != null && isPidRunning(pid);
-    if (!running && pid != null) {
-      removeWindowsPidFile();
-    }
-
-    return {
-      platform,
-      installed: pid != null,
-      running,
-      serviceName: "clawpilot (detached)",
-      manager: "windows-detached",
-      servicePath: existsSync(WINDOWS_PID_PATH) ? WINDOWS_PID_PATH : undefined,
-      logPath: LOG_PATH,
-      startHint: "clawpilot install",
-    };
-  }
-
-  return {
-    platform,
-    installed: false,
-    running: false,
-    serviceName: "",
-    manager: "unsupported",
-    logPath: LOG_PATH,
-  };
-}
-
-export const servicePaths = {
-  logPath: LOG_PATH,
-  errorLogPath: ERROR_LOG_PATH,
-  macPlistPath: MAC_PLIST_PATH,
-  linuxServicePath: LINUX_SERVICE_PATH,
-  linuxNohupPidPath: LINUX_NOHUP_PID_PATH,
-  linuxNohupStartScriptPath: LINUX_NOHUP_START_SCRIPT_PATH,
-  windowsPidPath: WINDOWS_PID_PATH,
-  windowsStartScriptPath: WINDOWS_START_SCRIPT_PATH,
-  windowsTaskName: WINDOWS_TASK_NAME,
-  pm2ProcessName: PM2_PROCESS_NAME,
-};
-
-export function supportsManagedServiceInstall(): boolean {
-  const platform = detectPlatform();
-  if (platform === "unsupported") return false;
-  if (platform === "macos") return true;
-  return isGlobalInstall() && canUsePm2();
-}
-
-export function getManagedServiceInstallHint(): string | undefined {
-  const platform = detectPlatform();
-  if (platform === "macos" || platform === "unsupported") return undefined;
-  if (!isGlobalInstall()) {
-    return process.platform === "win32"
-      ? "npm install -g @rethinkingstudio/clawpilot"
-      : "npm install -g @rethinkingstudio/clawpilot";
-  }
-  if (!canUsePm2()) {
-    return "pm2 dependency is missing from the current installation";
-  }
-  return undefined;
-}