refactor: unify gateway daemon install plan

src/commands/daemon-install-helpers.ts

@@ -0,0 +1,70 @@
+import path from "node:path";
+
+import { resolveGatewayLaunchAgentLabel } from "../daemon/constants.js";
+import { resolveGatewayProgramArguments } from "../daemon/program-args.js";
+import {
+  renderSystemNodeWarning,
+  resolvePreferredNodePath,
+  resolveSystemNodeInfo,
+} from "../daemon/runtime-paths.js";
+import { buildServiceEnvironment } from "../daemon/service-env.js";
+import type { GatewayDaemonRuntime } from "./daemon-runtime.js";
+
+type WarnFn = (message: string, title?: string) => void;
+
+export type GatewayInstallPlan = {
+  programArguments: string[];
+  workingDirectory?: string;
+  environment: Record<string, string | undefined>;
+};
+
+export function resolveGatewayDevMode(argv: string[] = process.argv): boolean {
+  const entry = argv[1];
+  return Boolean(entry?.includes(`${path.sep}src${path.sep}`) && entry.endsWith(".ts"));
+}
+
+export async function buildGatewayInstallPlan(params: {
+  env: Record<string, string | undefined>;
+  port: number;
+  runtime: GatewayDaemonRuntime;
+  token?: string;
+  devMode?: boolean;
+  nodePath?: string;
+  warn?: WarnFn;
+}): Promise<GatewayInstallPlan> {
+  const devMode = params.devMode ?? resolveGatewayDevMode();
+  const nodePath =
+    params.nodePath ??
+    (await resolvePreferredNodePath({
+      env: params.env,
+      runtime: params.runtime,
+    }));
+  const { programArguments, workingDirectory } = await resolveGatewayProgramArguments({
+    port: params.port,
+    dev: devMode,
+    runtime: params.runtime,
+    nodePath,
+  });
+  if (params.runtime === "node") {
+    const systemNode = await resolveSystemNodeInfo({ env: params.env });
+    const warning = renderSystemNodeWarning(systemNode, programArguments[0]);
+    if (warning) params.warn?.(warning, "Gateway runtime");
+  }
+  const environment = buildServiceEnvironment({
+    env: params.env,
+    port: params.port,
+    token: params.token,
+    launchdLabel:
+      process.platform === "darwin"
+        ? resolveGatewayLaunchAgentLabel(params.env.CLAWDBOT_PROFILE)
+        : undefined,
+  });
+
+  return { programArguments, workingDirectory, environment };
+}
+
+export function gatewayInstallErrorHint(platform = process.platform): string {
+  return platform === "win32"
+    ? "Tip: rerun from an elevated PowerShell (Start → type PowerShell → right-click → Run as administrator) or skip daemon install."
+    : "Tip: rerun `clawdbot daemon install` after fixing the error.";
+}