vultr/openclaw
1
0
Fork 0
mirror of https://github.com/openclaw/openclaw.git synced 2026-05-06 17:40:44 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs(daemon): clarify launchd lifecycle behavior

Browse Source
This commit is contained in:
Peter Steinberger
2026-04-10 21:28:59 +01:00
parent 8c6d231dba
commit 1f80ebf643
2 changed files with 8 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
src/daemon/launchd.ts
View File

@@ -205,6 +205,8 @@ async function bootstrapLaunchAgentOrThrow(params: {
plistPath: string;
actionHint: string;
}) {
// `disable` state survives bootout and plist rewrites; explicit start/repair
// paths must clear it before asking launchd to load the job again.
await execLaunchctl(["enable", params.serviceTarget]);
const boot = await execLaunchctl(["bootstrap", params.domain, params.plistPath]);
if (boot.code === 0) {
@@ -504,6 +506,8 @@ type LaunchAgentProbeResult =
| { state: "unknown"; detail?: string };
async function probeLaunchAgentState(serviceTarget: string): Promise<LaunchAgentProbeResult> {
// `launchctl print` output is not a stable API, so this is only a stop
// confirmation probe. Unknown output falls back to bootout instead of success.
const probe = await execLaunchctl(["print", serviceTarget]);
if (probe.code !== 0) {
if (isLaunchctlNotLoaded(probe)) {
@@ -545,8 +549,8 @@ export async function stopLaunchAgent({ stdout, env }: GatewayServiceControlArgs
const serviceTarget = `${domain}/${label}`;
// Keep the LaunchAgent installed, but persistently suppress KeepAlive/RunAtLoad
// before stopping the current process. If disable fails, fall back to bootout so
// the command still leaves the gateway down.
// before stopping the current process. Without `disable`, launchd can relaunch
// the process as soon as `stop` exits.
const disable = await execLaunchctl(["disable", serviceTarget]);
if (disable.code !== 0) {
await bootoutLaunchAgentOrThrow({