@xopcai/xopc 0.0.82 → 0.0.84

package/dist/src/cli/commands/gateway/lifecycle-core.js

@@ -1,160 +1,220 @@
 import { createLogger } from "../../../utils/logger/index.js";
 import { init_logger } from "../../../utils/logger.js";
+import { clearGatewayRestartIntentSync, writeGatewayRestartIntentSync } from "../../../infra/restart.js";
 //#region src/cli/commands/gateway/lifecycle-core.ts
 init_logger();
 const log = createLogger("DaemonLifecycle");
-async function executeDaemonStop(options) {
-	const { resolveGatewayService, isDaemonAvailableAsync } = await import("../../../daemon/service.js");
-	if (!await isDaemonAvailableAsync()) {
-		outputResult(options, {
+function emitResult(options, payload) {
+	if (options.json) {
+		console.log(JSON.stringify(payload, null, 2));
+		return;
+	}
+	if (payload.ok) {
+		if (payload.message) console.log(`✅ ${payload.message}`);
+		for (const warning of payload.warnings ?? []) console.warn(`⚠️  ${warning}`);
+		return;
+	}
+	if (payload.error) console.error(`❌ ${payload.error}`);
+	for (const hint of payload.hints ?? []) console.log(`💡 ${hint}`);
+}
+function createFail(options) {
+	return (message, hints, diagnostics, opts = options) => {
+		emitResult(opts, {
 			ok: false,
-			error: "Daemon service not available on this platform"
+			error: message,
+			hints
 		});
+		for (const line of diagnostics ?? []) if (!opts.json) console.log(`   ${line}`);
 		process.exit(1);
+	};
+}
+async function resolveServiceLoadedOrFail(service, fail) {
+	try {
+		return await service.isLoaded({ env: process.env });
+	} catch (err) {
+		fail(`Gateway service check failed: ${String(err)}`);
+		return null;
 	}
-	const service = await resolveGatewayService();
-	if (!await service.isLoaded({ env: process.env })) {
-		outputResult(options, {
-			ok: true,
-			result: "not-running",
-			message: `Gateway service ${service.notLoadedText}. Nothing to stop.`
+}
+async function handleServiceNotLoaded(params) {
+	emitResult(params.options, {
+		ok: true,
+		result: "not-loaded",
+		message: `Gateway service ${params.service.notLoadedText}.`,
+		hints: params.renderStartHints()
+	});
+}
+async function checkAndWarnTokenDrift(service, options) {
+	const warnings = [];
+	try {
+		const serviceToken = (await service.readCommand(process.env))?.environment?.XOPC_GATEWAY_TOKEN;
+		if (!serviceToken) return warnings;
+		const { loadConfig } = await import("../../../config/index.js");
+		const { resolveConfigPath } = await import("../../../config/paths.js");
+		const configToken = loadConfig(resolveConfigPath())?.gateway?.auth?.token;
+		if (configToken && serviceToken !== configToken) {
+			const warning = "Token drift detected: service token differs from config. Run `xopc gateway service install --force` to sync.";
+			warnings.push(warning);
+			if (!options.json) console.warn(`⚠️  ${warning}`);
+		}
+	} catch {}
+	return warnings;
+}
+async function runServiceStop(params) {
+	const options = params.opts ?? {};
+	const fail = createFail(options);
+	const loaded = await resolveServiceLoadedOrFail(params.service, fail);
+	if (loaded === null) return;
+	if (!loaded) {
+		try {
+			const handled = await params.onNotLoaded?.({
+				json: Boolean(options.json),
+				fail
+			});
+			if (handled) {
+				emitResult(options, {
+					ok: true,
+					result: handled.result,
+					message: handled.message,
+					warnings: handled.warnings
+				});
+				return;
+			}
+		} catch (err) {
+			fail(`Gateway stop failed: ${String(err)}`);
+			return;
+		}
+		await handleServiceNotLoaded({
+			service: params.service,
+			renderStartHints: () => ["xopc gateway service install", "xopc gateway"],
+			options
 		});
 		return;
 	}
 	try {
-		await service.stop({
+		await params.service.stop({
 			env: process.env,
 			disable: options.disable
 		});
-		outputResult(options, {
+		emitResult(options, {
 			ok: true,
 			result: "stopped",
 			message: options.disable ? "Gateway stopped and disabled (will not respawn)." : "Gateway stop signal sent."
 		});
 	} catch (err) {
-		const message = err instanceof Error ? err.message : String(err);
 		log.error({ err }, "Failed to stop gateway");
-		outputResult(options, {
-			ok: false,
-			error: `Failed to stop: ${message}`
-		});
-		process.exit(1);
+		fail(`Gateway stop failed: ${String(err)}`);
 	}
 }
-async function executeDaemonRestart(options) {
-	const { resolveGatewayService, isDaemonAvailableAsync } = await import("../../../daemon/service.js");
-	if (!await isDaemonAvailableAsync()) {
-		outputResult(options, {
-			ok: false,
-			error: "Daemon service not available on this platform"
-		});
-		process.exit(1);
-	}
-	const service = await resolveGatewayService();
-	if (!await service.isLoaded({ env: process.env })) {
-		outputResult(options, {
-			ok: false,
-			error: `Gateway service ${service.notLoadedText}. Install first with: xopc gateway service install`,
-			hints: ["xopc gateway service install"]
-		});
-		process.exit(1);
+async function runServiceRestart(params) {
+	const options = params.opts ?? {};
+	const fail = createFail(options);
+	const warnings = [];
+	let handledRecovery = null;
+	const loaded = await resolveServiceLoadedOrFail(params.service, fail);
+	if (loaded === null) return;
+	if (!loaded) {
+		try {
+			handledRecovery = await params.onNotLoaded?.({
+				json: Boolean(options.json),
+				fail
+			}) ?? null;
+		} catch (err) {
+			fail(`Gateway restart failed: ${String(err)}`);
+			return;
+		}
+		if (!handledRecovery) {
+			await handleServiceNotLoaded({
+				service: params.service,
+				renderStartHints: params.renderStartHints,
+				options
+			});
+			return;
+		}
+		if (handledRecovery.warnings?.length) warnings.push(...handledRecovery.warnings);
 	}
-	await checkAndWarnTokenDrift(service, options);
-	const { writeGatewayRestartIntentSync } = await import("../../../infra/restart-intent.js");
-	writeGatewayRestartIntentSync({ force: options.force });
+	if (loaded && params.checkTokenDrift) warnings.push(...await checkAndWarnTokenDrift(params.service, options));
 	try {
-		const result = await service.restart({ env: process.env });
-		if (options.wait) await waitForHealthAfterRestart(service, parseWaitTimeout(options.wait), options);
-		else outputResult(options, {
+		if (loaded) {
+			let wroteRestartIntent = false;
+			wroteRestartIntent = writeGatewayRestartIntentSync({ targetPid: (await params.service.readRuntime(process.env).catch(() => null))?.pid });
+			try {
+				await params.service.restart({ env: process.env });
+			} catch (err) {
+				if (wroteRestartIntent) clearGatewayRestartIntentSync();
+				throw err;
+			}
+		}
+		if (params.postRestartCheck) await params.postRestartCheck({
+			options,
+			fail
+		});
+		if (options.wait) {
+			const timeoutMs = parseWaitTimeout(options.wait);
+			const { loadConfig } = await import("../../../config/index.js");
+			const { resolveConfigPath } = await import("../../../config/paths.js");
+			const config = loadConfig(resolveConfigPath());
+			const port = typeof config.gateway?.port === "number" ? config.gateway.port : 18790;
+			const { waitForRestartHealth } = await import("./restart-health.js");
+			const snapshot = await waitForRestartHealth({
+				service: params.service,
+				port,
+				timeoutMs,
+				onProgress: () => {
+					if (!options.json) process.stdout.write(".");
+				}
+			});
+			if (!options.json) process.stdout.write("\n");
+			if (!snapshot.healthy) {
+				fail(`Restart health check failed: ${snapshot.waitOutcome ?? "timeout"}`, ["xopc gateway logs"]);
+				return;
+			}
+			emitResult(options, {
+				ok: true,
+				result: "healthy",
+				message: `Gateway restarted and healthy (pid ${snapshot.runtime?.pid ?? "unknown"}, ${snapshot.elapsedMs ?? 0}ms).`,
+				warnings: warnings.length ? warnings : void 0
+			});
+			return;
+		}
+		emitResult(options, {
 			ok: true,
-			result: result.outcome,
-			message: `Gateway restart ${result.outcome}.`
+			result: "restarted",
+			message: handledRecovery?.message ?? "Gateway restart completed.",
+			warnings: warnings.length ? warnings : void 0
 		});
 	} catch (err) {
-		const message = err instanceof Error ? err.message : String(err);
 		log.error({ err }, "Failed to restart gateway");
-		outputResult(options, {
-			ok: false,
-			error: `Failed to restart: ${message}`
-		});
-		process.exit(1);
+		fail(`Gateway restart failed: ${String(err)}`, params.renderStartHints());
 	} finally {
-		const { clearGatewayRestartIntentSync } = await import("../../../infra/restart-intent.js");
 		clearGatewayRestartIntentSync();
 	}
 }
-async function executeDaemonUninstall(options) {
+async function executeDaemonUninstall(options = {}) {
 	const { resolveGatewayService, isDaemonAvailableAsync } = await import("../../../daemon/service.js");
 	if (!await isDaemonAvailableAsync()) {
-		outputResult(options, {
+		emitResult(options, {
 			ok: false,
 			error: "Daemon service not available on this platform"
 		});
 		process.exit(1);
 	}
 	const service = await resolveGatewayService();
+	if (await service.isLoaded({ env: process.env }).catch(() => false)) try {
+		await service.stop({ env: process.env });
+	} catch {}
 	try {
 		await service.uninstall({ env: process.env });
-		outputResult(options, {
+		emitResult(options, {
 			ok: true,
 			result: "uninstalled",
 			message: "Gateway service uninstalled."
 		});
 	} catch (err) {
-		const message = err instanceof Error ? err.message : String(err);
 		log.error({ err }, "Failed to uninstall gateway service");
-		outputResult(options, {
+		emitResult(options, {
 			ok: false,
-			error: `Failed to uninstall: ${message}`
-		});
-		process.exit(1);
-	}
-}
-async function checkAndWarnTokenDrift(service, options) {
-	try {
-		const command = await service.readCommand(process.env);
-		if (!command?.environment?.XOPC_GATEWAY_TOKEN) return;
-		const { loadConfig } = await import("../../../config/index.js");
-		const { resolveConfigPath } = await import("../../../config/paths.js");
-		const configToken = loadConfig(resolveConfigPath())?.gateway?.auth?.token;
-		if (configToken && command.environment.XOPC_GATEWAY_TOKEN !== configToken) {
-			const warning = "Token drift detected: service token differs from config. Run `xopc gateway service install --force` to sync.";
-			if (options.json) {} else console.warn(`⚠️  ${warning}`);
-		}
-	} catch {}
-}
-async function waitForHealthAfterRestart(service, timeoutMs, options) {
-	const { loadConfig } = await import("../../../config/index.js");
-	const { resolveConfigPath } = await import("../../../config/paths.js");
-	const port = loadConfig(resolveConfigPath())?.gateway?.port ?? 18790;
-	try {
-		const { waitForRestartHealth } = await import("./restart-health.js");
-		const snapshot = await waitForRestartHealth({
-			service,
-			port,
-			timeoutMs,
-			onProgress: (_snap) => {
-				if (!options.json) process.stdout.write(".");
-			}
-		});
-		if (!options.json) process.stdout.write("\n");
-		if (snapshot.healthy) outputResult(options, {
-			ok: true,
-			result: "healthy",
-			message: `Gateway restarted and healthy (pid ${snapshot.runtime?.pid ?? "unknown"}, ${snapshot.elapsedMs}ms).`
-		});
-		else {
-			outputResult(options, {
-				ok: false,
-				error: `Restart health check failed: ${snapshot.waitOutcome}`,
-				hints: ["Check logs with: xopc gateway logs"]
-			});
-			process.exit(1);
-		}
-	} catch (err) {
-		outputResult(options, {
-			ok: false,
-			error: `Health wait failed: ${err instanceof Error ? err.message : String(err)}`
+			error: `Failed to uninstall: ${String(err)}`
 		});
 		process.exit(1);
 	}
@@ -169,16 +229,7 @@ function parseWaitTimeout(wait) {
 		default: return value * 1e3;
 	}
 }
-function outputResult(options, output) {
-	if (options.json) console.log(JSON.stringify(output, null, 2));
-	else if (output.ok) {
-		if (output.message) console.log(`✅ ${output.message}`);
-	} else {
-		if (output.error) console.error(`❌ ${output.error}`);
-		if (output.hints) for (const hint of output.hints) console.log(`💡 ${hint}`);
-	}
-}
 //#endregion
-export { executeDaemonRestart, executeDaemonStop, executeDaemonUninstall };
+export { executeDaemonUninstall, runServiceRestart, runServiceStop };
 
 //# sourceMappingURL=lifecycle-core.js.map

package/dist/src/cli/commands/gateway/lifecycle-core.js.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle-core.js","names":[],"sources":["../../../../../src/cli/commands/gateway/lifecycle-core.ts"],"sourcesContent":["/**\n * Daemon Lifecycle Core - Unified start/stop/restart/uninstall logic\n *\n * Entry point for all daemon lifecycle operations. Handles:\n * - Service resolution and availability checks\n * - Token drift detection\n * - Restart intent writing\n * - Health wait coordination\n * - JSON output mode\n */\n\nimport { createLogger } from '../../../utils/logger.js';\nimport type {\n  DaemonLifecycleOptions,\n  GatewayServiceRestartResult,\n} from '../../../daemon/types.js';\n\nconst log = createLogger('DaemonLifecycle');\n\n// ─── Stop ───\n\nexport async function executeDaemonStop(options: DaemonLifecycleOptions): Promise<void> {\n  const { resolveGatewayService, isDaemonAvailableAsync } = await import(\n    '../../../daemon/service.js'\n  );\n\n  const available = await isDaemonAvailableAsync();\n  if (!available) {\n    outputResult(options, { ok: false, error: 'Daemon service not available on this platform' });\n    process.exit(1);\n  }\n\n  const service = await resolveGatewayService();\n  const loaded = await service.isLoaded({ env: process.env });\n\n  if (!loaded) {\n    outputResult(options, {\n      ok: true,\n      result: 'not-running',\n      message: `Gateway service ${service.notLoadedText}. Nothing to stop.`,\n    });\n    return;\n  }\n\n  try {\n    await service.stop({ env: process.env, disable: options.disable });\n    outputResult(options, {\n      ok: true,\n      result: 'stopped',\n      message: options.disable\n        ? 'Gateway stopped and disabled (will not respawn).'\n        : 'Gateway stop signal sent.',\n    });\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    log.error({ err }, 'Failed to stop gateway');\n    outputResult(options, { ok: false, error: `Failed to stop: ${message}` });\n    process.exit(1);\n  }\n}\n\n// ─── Restart ───\n\nexport async function executeDaemonRestart(options: DaemonLifecycleOptions): Promise<void> {\n  const { resolveGatewayService, isDaemonAvailableAsync } = await import(\n    '../../../daemon/service.js'\n  );\n\n  const available = await isDaemonAvailableAsync();\n  if (!available) {\n    outputResult(options, { ok: false, error: 'Daemon service not available on this platform' });\n    process.exit(1);\n  }\n\n  const service = await resolveGatewayService();\n  const loaded = await service.isLoaded({ env: process.env });\n\n  if (!loaded) {\n    outputResult(options, {\n      ok: false,\n      error: `Gateway service ${service.notLoadedText}. Install first with: xopc gateway service install`,\n      hints: ['xopc gateway service install'],\n    });\n    process.exit(1);\n  }\n\n  // Token drift check\n  await checkAndWarnTokenDrift(service, options);\n\n  // Write restart intent\n  const { writeGatewayRestartIntentSync } = await import('../../../infra/restart-intent.js');\n  writeGatewayRestartIntentSync({ force: options.force });\n\n  try {\n    const result: GatewayServiceRestartResult = await service.restart({ env: process.env });\n\n    // If --wait specified, wait for health\n    if (options.wait) {\n      const timeoutMs = parseWaitTimeout(options.wait);\n      await waitForHealthAfterRestart(service, timeoutMs, options);\n    } else {\n      outputResult(options, {\n        ok: true,\n        result: result.outcome,\n        message: `Gateway restart ${result.outcome}.`,\n      });\n    }\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    log.error({ err }, 'Failed to restart gateway');\n    outputResult(options, { ok: false, error: `Failed to restart: ${message}` });\n    process.exit(1);\n  } finally {\n    // Clean up intent\n    const { clearGatewayRestartIntentSync } = await import('../../../infra/restart-intent.js');\n    clearGatewayRestartIntentSync();\n  }\n}\n\n// ─── Uninstall ───\n\nexport async function executeDaemonUninstall(options: DaemonLifecycleOptions): Promise<void> {\n  const { resolveGatewayService, isDaemonAvailableAsync } = await import(\n    '../../../daemon/service.js'\n  );\n\n  const available = await isDaemonAvailableAsync();\n  if (!available) {\n    outputResult(options, { ok: false, error: 'Daemon service not available on this platform' });\n    process.exit(1);\n  }\n\n  const service = await resolveGatewayService();\n\n  try {\n    await service.uninstall({ env: process.env });\n    outputResult(options, {\n      ok: true,\n      result: 'uninstalled',\n      message: 'Gateway service uninstalled.',\n    });\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    log.error({ err }, 'Failed to uninstall gateway service');\n    outputResult(options, { ok: false, error: `Failed to uninstall: ${message}` });\n    process.exit(1);\n  }\n}\n\n// ─── Token Drift Check ───\n\nasync function checkAndWarnTokenDrift(\n  service: { readCommand: (env?: Record<string, string | undefined>) => Promise<{ environment?: Record<string, string> } | null> },\n  options: DaemonLifecycleOptions,\n): Promise<void> {\n  try {\n    const command = await service.readCommand(process.env);\n    if (!command?.environment?.XOPC_GATEWAY_TOKEN) return;\n\n    const { loadConfig } = await import('../../../config/index.js');\n    const { resolveConfigPath } = await import('../../../config/paths.js');\n    const config = loadConfig(resolveConfigPath());\n    const configToken = config?.gateway?.auth?.token;\n\n    if (configToken && command.environment.XOPC_GATEWAY_TOKEN !== configToken) {\n      const warning =\n        'Token drift detected: service token differs from config. ' +\n        'Run `xopc gateway service install --force` to sync.';\n\n      if (options.json) {\n        // Will be included in output\n      } else {\n        console.warn(`⚠️  ${warning}`);\n      }\n    }\n  } catch {\n    // Best-effort; don't block restart on drift check failure\n  }\n}\n\n// ─── Health Wait ───\n\nasync function waitForHealthAfterRestart(\n  service: { readRuntime: (env?: Record<string, string | undefined>) => Promise<{ status: string; pid?: number }> },\n  timeoutMs: number,\n  options: DaemonLifecycleOptions,\n): Promise<void> {\n  const { loadConfig } = await import('../../../config/index.js');\n  const { resolveConfigPath } = await import('../../../config/paths.js');\n  const config = loadConfig(resolveConfigPath());\n  const port = config?.gateway?.port ?? 18790;\n\n  try {\n    const { waitForRestartHealth } = await import('./restart-health.js');\n    const snapshot = await waitForRestartHealth({\n      service: service as any,\n      port,\n      timeoutMs,\n      onProgress: (_snap) => {\n        if (!options.json) {\n          process.stdout.write('.');\n        }\n      },\n    });\n\n    if (!options.json) {\n      process.stdout.write('\\n');\n    }\n\n    if (snapshot.healthy) {\n      outputResult(options, {\n        ok: true,\n        result: 'healthy',\n        message: `Gateway restarted and healthy (pid ${snapshot.runtime?.pid ?? 'unknown'}, ${snapshot.elapsedMs}ms).`,\n      });\n    } else {\n      outputResult(options, {\n        ok: false,\n        error: `Restart health check failed: ${snapshot.waitOutcome}`,\n        hints: ['Check logs with: xopc gateway logs'],\n      });\n      process.exit(1);\n    }\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    outputResult(options, {\n      ok: false,\n      error: `Health wait failed: ${message}`,\n    });\n    process.exit(1);\n  }\n}\n\n// ─── Helpers ───\n\nfunction parseWaitTimeout(wait: string): number {\n  const match = wait.match(/^(\\d+)(s|m|ms)?$/);\n  if (!match) return 60_000;\n\n  const value = parseInt(match[1], 10);\n  const unit = match[2] || 's';\n\n  switch (unit) {\n    case 'ms': return value;\n    case 'm': return value * 60_000;\n    case 's':\n    default: return value * 1000;\n  }\n}\n\ninterface LifecycleOutput {\n  ok: boolean;\n  result?: string;\n  message?: string;\n  error?: string;\n  hints?: string[];\n}\n\nfunction outputResult(options: DaemonLifecycleOptions, output: LifecycleOutput): void {\n  if (options.json) {\n    console.log(JSON.stringify(output, null, 2));\n  } else if (output.ok) {\n    if (output.message) {\n      console.log(`✅ ${output.message}`);\n    }\n  } else {\n    if (output.error) {\n      console.error(`❌ ${output.error}`);\n    }\n    if (output.hints) {\n      for (const hint of output.hints) {\n        console.log(`💡 ${hint}`);\n      }\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"lifecycle-core.js","names":[],"sources":["../../../../../src/cli/commands/gateway/lifecycle-core.ts"],"sourcesContent":["/**\n * Daemon lifecycle core — OpenClaw-aligned service start/stop/restart with onNotLoaded fallback.\n */\n\nimport { createLogger } from '../../../utils/logger.js';\nimport type {\n  DaemonLifecycleOptions,\n  GatewayService,\n} from '../../../daemon/types.js';\nimport {\n  clearGatewayRestartIntentSync,\n  writeGatewayRestartIntentSync,\n} from '../../../infra/restart.js';\n\nconst log = createLogger('DaemonLifecycle');\n\nexport type ServiceRecoveryResult = {\n  result: 'started' | 'stopped' | 'restarted';\n  message?: string;\n  warnings?: string[];\n  loaded?: boolean;\n};\n\ntype ServiceRecoveryContext = {\n  json: boolean;\n  fail: (message: string, hints?: string[], diagnostics?: string[], options?: DaemonLifecycleOptions) => void;\n};\n\ntype RestartPostCheckContext = {\n  options: DaemonLifecycleOptions;\n  fail: (message: string, hints?: string[], diagnostics?: string[], options?: DaemonLifecycleOptions) => void;\n};\n\nfunction emitResult(\n  options: DaemonLifecycleOptions,\n  payload: {\n    ok: boolean;\n    result?: string;\n    message?: string;\n    error?: string;\n    hints?: string[];\n    warnings?: string[];\n  },\n): void {\n  if (options.json) {\n    console.log(JSON.stringify(payload, null, 2));\n    return;\n  }\n  if (payload.ok) {\n    if (payload.message) {\n      console.log(`✅ ${payload.message}`);\n    }\n    for (const warning of payload.warnings ?? []) {\n      console.warn(`⚠️  ${warning}`);\n    }\n    return;\n  }\n  if (payload.error) {\n    console.error(`❌ ${payload.error}`);\n  }\n  for (const hint of payload.hints ?? []) {\n    console.log(`💡 ${hint}`);\n  }\n}\n\nfunction createFail(options: DaemonLifecycleOptions) {\n  return (\n    message: string,\n    hints?: string[],\n    diagnostics?: string[],\n    opts: DaemonLifecycleOptions = options,\n  ) => {\n    emitResult(opts, { ok: false, error: message, hints });\n    for (const line of diagnostics ?? []) {\n      if (!opts.json) {\n        console.log(`   ${line}`);\n      }\n    }\n    process.exit(1);\n  };\n}\n\nasync function resolveServiceLoadedOrFail(\n  service: GatewayService,\n  fail: ServiceRecoveryContext['fail'],\n): Promise<boolean | null> {\n  try {\n    return await service.isLoaded({ env: process.env });\n  } catch (err) {\n    fail(`Gateway service check failed: ${String(err)}`);\n    return null;\n  }\n}\n\nasync function handleServiceNotLoaded(params: {\n  service: GatewayService;\n  renderStartHints: () => string[];\n  options: DaemonLifecycleOptions;\n}): Promise<void> {\n  emitResult(params.options, {\n    ok: true,\n    result: 'not-loaded',\n    message: `Gateway service ${params.service.notLoadedText}.`,\n    hints: params.renderStartHints(),\n  });\n}\n\nasync function checkAndWarnTokenDrift(\n  service: GatewayService,\n  options: DaemonLifecycleOptions,\n): Promise<string[]> {\n  const warnings: string[] = [];\n  try {\n    const command = await service.readCommand(process.env);\n    const serviceToken = command?.environment?.XOPC_GATEWAY_TOKEN;\n    if (!serviceToken) {\n      return warnings;\n    }\n    const { loadConfig } = await import('../../../config/index.js');\n    const { resolveConfigPath } = await import('../../../config/paths.js');\n    const config = loadConfig(resolveConfigPath());\n    const configToken = config?.gateway?.auth?.token;\n    if (configToken && serviceToken !== configToken) {\n      const warning =\n        'Token drift detected: service token differs from config. Run `xopc gateway service install --force` to sync.';\n      warnings.push(warning);\n      if (!options.json) {\n        console.warn(`⚠️  ${warning}`);\n      }\n    }\n  } catch {\n    // Best-effort\n  }\n  return warnings;\n}\n\nexport async function runServiceStop(params: {\n  service: GatewayService;\n  opts?: DaemonLifecycleOptions;\n  onNotLoaded?: (ctx: ServiceRecoveryContext) => Promise<ServiceRecoveryResult | null>;\n}): Promise<void> {\n  const options = params.opts ?? {};\n  const fail = createFail(options);\n  const loaded = await resolveServiceLoadedOrFail(params.service, fail);\n  if (loaded === null) {\n    return;\n  }\n\n  if (!loaded) {\n    try {\n      const handled = await params.onNotLoaded?.({ json: Boolean(options.json), fail });\n      if (handled) {\n        emitResult(options, {\n          ok: true,\n          result: handled.result,\n          message: handled.message,\n          warnings: handled.warnings,\n        });\n        return;\n      }\n    } catch (err) {\n      fail(`Gateway stop failed: ${String(err)}`);\n      return;\n    }\n    await handleServiceNotLoaded({\n      service: params.service,\n      renderStartHints: () => ['xopc gateway service install', 'xopc gateway'],\n      options,\n    });\n    return;\n  }\n\n  try {\n    await params.service.stop({ env: process.env, disable: options.disable });\n    emitResult(options, {\n      ok: true,\n      result: 'stopped',\n      message: options.disable\n        ? 'Gateway stopped and disabled (will not respawn).'\n        : 'Gateway stop signal sent.',\n    });\n  } catch (err) {\n    log.error({ err }, 'Failed to stop gateway');\n    fail(`Gateway stop failed: ${String(err)}`);\n  }\n}\n\nexport async function runServiceRestart(params: {\n  service: GatewayService;\n  opts?: DaemonLifecycleOptions;\n  renderStartHints: () => string[];\n  checkTokenDrift?: boolean;\n  onNotLoaded?: (ctx: ServiceRecoveryContext) => Promise<ServiceRecoveryResult | null>;\n  postRestartCheck?: (ctx: RestartPostCheckContext) => Promise<void>;\n}): Promise<void> {\n  const options = params.opts ?? {};\n  const fail = createFail(options);\n  const warnings: string[] = [];\n  let handledRecovery: ServiceRecoveryResult | null = null;\n\n  const loaded = await resolveServiceLoadedOrFail(params.service, fail);\n  if (loaded === null) {\n    return;\n  }\n\n  if (!loaded) {\n    try {\n      handledRecovery = (await params.onNotLoaded?.({ json: Boolean(options.json), fail })) ?? null;\n    } catch (err) {\n      fail(`Gateway restart failed: ${String(err)}`);\n      return;\n    }\n    if (!handledRecovery) {\n      await handleServiceNotLoaded({\n        service: params.service,\n        renderStartHints: params.renderStartHints,\n        options,\n      });\n      return;\n    }\n    if (handledRecovery.warnings?.length) {\n      warnings.push(...handledRecovery.warnings);\n    }\n  }\n\n  if (loaded && params.checkTokenDrift) {\n    warnings.push(...(await checkAndWarnTokenDrift(params.service, options)));\n  }\n\n  try {\n    if (loaded) {\n      let wroteRestartIntent = false;\n      const runtime = await params.service.readRuntime(process.env).catch(() => null);\n      wroteRestartIntent = writeGatewayRestartIntentSync({ targetPid: runtime?.pid });\n      try {\n        await params.service.restart({ env: process.env });\n      } catch (err) {\n        if (wroteRestartIntent) {\n          clearGatewayRestartIntentSync();\n        }\n        throw err;\n      }\n    }\n\n    if (params.postRestartCheck) {\n      await params.postRestartCheck({ options, fail });\n    }\n\n    if (options.wait) {\n      const timeoutMs = parseWaitTimeout(options.wait);\n      const { loadConfig } = await import('../../../config/index.js');\n      const { resolveConfigPath } = await import('../../../config/paths.js');\n      const config = loadConfig(resolveConfigPath());\n      const port = typeof config.gateway?.port === 'number' ? config.gateway.port : 18790;\n      const { waitForRestartHealth } = await import('./restart-health.js');\n      const snapshot = await waitForRestartHealth({\n        service: params.service,\n        port,\n        timeoutMs,\n        onProgress: () => {\n          if (!options.json) {\n            process.stdout.write('.');\n          }\n        },\n      });\n      if (!options.json) {\n        process.stdout.write('\\n');\n      }\n      if (!snapshot.healthy) {\n        fail(`Restart health check failed: ${snapshot.waitOutcome ?? 'timeout'}`, [\n          'xopc gateway logs',\n        ]);\n        return;\n      }\n      emitResult(options, {\n        ok: true,\n        result: 'healthy',\n        message: `Gateway restarted and healthy (pid ${snapshot.runtime?.pid ?? 'unknown'}, ${snapshot.elapsedMs ?? 0}ms).`,\n        warnings: warnings.length ? warnings : undefined,\n      });\n      return;\n    }\n\n    emitResult(options, {\n      ok: true,\n      result: 'restarted',\n      message: handledRecovery?.message ?? 'Gateway restart completed.',\n      warnings: warnings.length ? warnings : undefined,\n    });\n  } catch (err) {\n    log.error({ err }, 'Failed to restart gateway');\n    fail(`Gateway restart failed: ${String(err)}`, params.renderStartHints());\n  } finally {\n    clearGatewayRestartIntentSync();\n  }\n}\n\nexport async function executeDaemonUninstall(options: DaemonLifecycleOptions = {}): Promise<void> {\n  const { resolveGatewayService, isDaemonAvailableAsync } = await import('../../../daemon/service.js');\n  const available = await isDaemonAvailableAsync();\n  if (!available) {\n    emitResult(options, { ok: false, error: 'Daemon service not available on this platform' });\n    process.exit(1);\n  }\n  const service = await resolveGatewayService();\n  const loaded = await service.isLoaded({ env: process.env }).catch(() => false);\n  if (loaded) {\n    try {\n      await service.stop({ env: process.env });\n    } catch {\n      // Best-effort\n    }\n  }\n  try {\n    await service.uninstall({ env: process.env });\n    emitResult(options, { ok: true, result: 'uninstalled', message: 'Gateway service uninstalled.' });\n  } catch (err) {\n    log.error({ err }, 'Failed to uninstall gateway service');\n    emitResult(options, { ok: false, error: `Failed to uninstall: ${String(err)}` });\n    process.exit(1);\n  }\n}\n\nfunction parseWaitTimeout(wait: string): number {\n  const match = wait.match(/^(\\d+)(s|m|ms)?$/);\n  if (!match) return 60_000;\n  const value = parseInt(match[1], 10);\n  const unit = match[2] || 's';\n  switch (unit) {\n    case 'ms':\n      return value;\n    case 'm':\n      return value * 60_000;\n    case 's':\n    default:\n      return value * 1000;\n  }\n}\n"],"mappings":"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"}

package/dist/src/cli/commands/gateway/lifecycle.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Gateway lifecycle orchestration — OpenClaw-aligned service + unmanaged fallback.
+ */
+export declare function runDaemonStop(options?: {
+    json?: boolean;
+    disable?: boolean;
+}): Promise<void>;
+export declare function runDaemonRestart(options?: {
+    json?: boolean;
+    wait?: string;
+}): Promise<void>;

package/dist/src/cli/commands/gateway/lifecycle.js

@@ -0,0 +1,102 @@
+import { init_paths, resolveConfigPath } from "../../../config/paths.js";
+import { loadConfig } from "../../../config/loader.js";
+import "../../../config/index.js";
+import { isRestartEnabled } from "../../../config/commands.flags.js";
+import { resolveGatewayService } from "../../../daemon/service.js";
+import { authorizeGatewaySigusr1Restart } from "../../../infra/restart.js";
+import { findVerifiedGatewayListenerPidsOnPortSync, formatGatewayPidList, signalVerifiedGatewayPidSync } from "../../../infra/gateway-processes.js";
+import { runServiceRestart, runServiceStop } from "./lifecycle-core.js";
+import { DEFAULT_RESTART_HEALTH_ATTEMPTS, renderGatewayPortHealthDiagnostics, waitForGatewayHealthyListener } from "./restart-health.js";
+import { parsePortFromArgs, renderGatewayServiceStartHints, resolveGatewayPortFromConfig } from "./shared.js";
+//#region src/cli/commands/gateway/lifecycle.ts
+/**
+* Gateway lifecycle orchestration — OpenClaw-aligned service + unmanaged fallback.
+*/
+init_paths();
+const POST_RESTART_HEALTH_ATTEMPTS = DEFAULT_RESTART_HEALTH_ATTEMPTS;
+const POST_RESTART_HEALTH_DELAY_MS = 500;
+async function resolveGatewayLifecyclePort(service) {
+	return parsePortFromArgs((await (service ?? await resolveGatewayService()).readCommand(process.env).catch(() => null))?.programArguments) ?? resolveGatewayPortFromConfig();
+}
+function resolveVerifiedGatewayListenerPids(port) {
+	return findVerifiedGatewayListenerPidsOnPortSync(port).filter((pid) => Number.isFinite(pid) && pid > 0);
+}
+async function assertUnmanagedGatewayRestartEnabled(port) {
+	if (!isRestartEnabled(loadConfig(resolveConfigPath()))) throw new Error("Gateway restart is disabled in config (commands.restart=false); unmanaged SIGUSR1 restart would be ignored");
+	try {
+		const controller = new AbortController();
+		const timeout = setTimeout(() => controller.abort(), 1e3);
+		const response = await fetch(`http://127.0.0.1:${port}/api/health`, {
+			method: "GET",
+			signal: controller.signal
+		});
+		clearTimeout(timeout);
+		if (!response.ok) return;
+	} catch {}
+}
+async function stopGatewayWithoutServiceManager(port) {
+	const pids = resolveVerifiedGatewayListenerPids(port);
+	if (pids.length === 0) return null;
+	for (const pid of pids) signalVerifiedGatewayPidSync(pid, "SIGTERM");
+	return {
+		result: "stopped",
+		message: `Gateway stop signal sent to unmanaged process${pids.length === 1 ? "" : "es"} on port ${port}: ${formatGatewayPidList(pids)}.`
+	};
+}
+async function restartGatewayWithoutServiceManager(port) {
+	await assertUnmanagedGatewayRestartEnabled(port);
+	const pids = resolveVerifiedGatewayListenerPids(port);
+	if (pids.length === 0) return null;
+	if (pids.length > 1) throw new Error(`multiple gateway processes are listening on port ${port}: ${formatGatewayPidList(pids)}; use "xopc gateway status" before retrying restart`);
+	authorizeGatewaySigusr1Restart();
+	signalVerifiedGatewayPidSync(pids[0], "SIGUSR1");
+	return {
+		result: "restarted",
+		message: `Gateway restart signal sent to unmanaged process on port ${port}: ${pids[0]}.`
+	};
+}
+async function runDaemonStop(options = {}) {
+	const service = await resolveGatewayService();
+	let gatewayPortPromise;
+	await runServiceStop({
+		service,
+		opts: options,
+		onNotLoaded: async () => {
+			gatewayPortPromise ??= resolveGatewayLifecyclePort(service);
+			return stopGatewayWithoutServiceManager(await gatewayPortPromise);
+		}
+	});
+}
+async function runDaemonRestart(options = {}) {
+	const service = await resolveGatewayService();
+	let restartedWithoutServiceManager = false;
+	const restartPort = await resolveGatewayLifecyclePort(service);
+	const restartHealthAttempts = POST_RESTART_HEALTH_ATTEMPTS;
+	const restartWaitSeconds = Math.round(restartHealthAttempts * POST_RESTART_HEALTH_DELAY_MS / 1e3);
+	await runServiceRestart({
+		service,
+		opts: options,
+		renderStartHints: renderGatewayServiceStartHints,
+		checkTokenDrift: true,
+		onNotLoaded: async () => {
+			const handled = await restartGatewayWithoutServiceManager(restartPort);
+			if (handled) restartedWithoutServiceManager = true;
+			return handled;
+		},
+		postRestartCheck: async ({ options: opts, fail }) => {
+			if (!restartedWithoutServiceManager) return;
+			const health = await waitForGatewayHealthyListener({
+				port: restartPort,
+				attempts: restartHealthAttempts,
+				delayMs: POST_RESTART_HEALTH_DELAY_MS
+			});
+			if (health.healthy) return;
+			const diagnostics = renderGatewayPortHealthDiagnostics(health);
+			fail(`Gateway restart timed out after ${restartWaitSeconds}s waiting for health checks.`, ["xopc gateway status", "xopc doctor"], diagnostics, opts);
+		}
+	});
+}
+//#endregion
+export { runDaemonRestart, runDaemonStop };
+
+//# sourceMappingURL=lifecycle.js.map

package/dist/src/cli/commands/gateway/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","names":[],"sources":["../../../../../src/cli/commands/gateway/lifecycle.ts"],"sourcesContent":["/**\n * Gateway lifecycle orchestration — OpenClaw-aligned service + unmanaged fallback.\n */\n\nimport { isRestartEnabled } from '../../../config/commands.flags.js';\nimport { loadConfig } from '../../../config/index.js';\nimport { resolveConfigPath } from '../../../config/paths.js';\nimport { resolveGatewayService } from '../../../daemon/service.js';\nimport {\n  findVerifiedGatewayListenerPidsOnPortSync,\n  formatGatewayPidList,\n  signalVerifiedGatewayPidSync,\n} from '../../../infra/gateway-processes.js';\nimport { authorizeGatewaySigusr1Restart } from '../../../infra/restart.js';\nimport {\n  DEFAULT_RESTART_HEALTH_ATTEMPTS,\n  DEFAULT_RESTART_HEALTH_DELAY_MS,\n  renderGatewayPortHealthDiagnostics,\n  waitForGatewayHealthyListener,\n} from './restart-health.js';\nimport {\n  parsePortFromArgs,\n  renderGatewayServiceStartHints,\n  resolveGatewayPortFromConfig,\n} from './shared.js';\nimport {\n  runServiceRestart,\n  runServiceStop,\n  type ServiceRecoveryResult,\n} from './lifecycle-core.js';\n\nconst POST_RESTART_HEALTH_ATTEMPTS = DEFAULT_RESTART_HEALTH_ATTEMPTS;\nconst POST_RESTART_HEALTH_DELAY_MS = DEFAULT_RESTART_HEALTH_DELAY_MS;\n\nasync function resolveGatewayLifecyclePort(service?: Awaited<ReturnType<typeof resolveGatewayService>>): Promise<number> {\n  const resolvedService = service ?? (await resolveGatewayService());\n  const command = await resolvedService.readCommand(process.env).catch(() => null);\n  const portFromArgs = parsePortFromArgs(command?.programArguments);\n  return portFromArgs ?? resolveGatewayPortFromConfig();\n}\n\nfunction resolveVerifiedGatewayListenerPids(port: number): number[] {\n  return findVerifiedGatewayListenerPidsOnPortSync(port).filter(\n    (pid): pid is number => Number.isFinite(pid) && pid > 0,\n  );\n}\n\nasync function assertUnmanagedGatewayRestartEnabled(port: number): Promise<void> {\n  const config = loadConfig(resolveConfigPath());\n  if (!isRestartEnabled(config)) {\n    throw new Error(\n      'Gateway restart is disabled in config (commands.restart=false); unmanaged SIGUSR1 restart would be ignored',\n    );\n  }\n\n  try {\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), 1000);\n    const response = await fetch(`http://127.0.0.1:${port}/api/health`, {\n      method: 'GET',\n      signal: controller.signal,\n    });\n    clearTimeout(timeout);\n    if (!response.ok) {\n      return;\n    }\n  } catch {\n    // Best-effort probe; unmanaged restart may still target a starting gateway.\n  }\n}\n\nasync function stopGatewayWithoutServiceManager(port: number): Promise<ServiceRecoveryResult | null> {\n  const pids = resolveVerifiedGatewayListenerPids(port);\n  if (pids.length === 0) {\n    return null;\n  }\n  for (const pid of pids) {\n    signalVerifiedGatewayPidSync(pid, 'SIGTERM');\n  }\n  return {\n    result: 'stopped',\n    message: `Gateway stop signal sent to unmanaged process${pids.length === 1 ? '' : 'es'} on port ${port}: ${formatGatewayPidList(pids)}.`,\n  };\n}\n\nasync function restartGatewayWithoutServiceManager(port: number): Promise<ServiceRecoveryResult | null> {\n  await assertUnmanagedGatewayRestartEnabled(port);\n  const pids = resolveVerifiedGatewayListenerPids(port);\n  if (pids.length === 0) {\n    return null;\n  }\n  if (pids.length > 1) {\n    throw new Error(\n      `multiple gateway processes are listening on port ${port}: ${formatGatewayPidList(pids)}; use \"xopc gateway status\" before retrying restart`,\n    );\n  }\n  authorizeGatewaySigusr1Restart();\n  signalVerifiedGatewayPidSync(pids[0], 'SIGUSR1');\n  return {\n    result: 'restarted',\n    message: `Gateway restart signal sent to unmanaged process on port ${port}: ${pids[0]}.`,\n  };\n}\n\nexport async function runDaemonStop(options: { json?: boolean; disable?: boolean } = {}): Promise<void> {\n  const service = await resolveGatewayService();\n  let gatewayPortPromise: Promise<number> | undefined;\n\n  await runServiceStop({\n    service,\n    opts: options,\n    onNotLoaded: async () => {\n      gatewayPortPromise ??= resolveGatewayLifecyclePort(service);\n      return stopGatewayWithoutServiceManager(await gatewayPortPromise);\n    },\n  });\n}\n\nexport async function runDaemonRestart(options: {\n  json?: boolean;\n  wait?: string;\n} = {}): Promise<void> {\n  const service = await resolveGatewayService();\n  let restartedWithoutServiceManager = false;\n  const restartPort = await resolveGatewayLifecyclePort(service);\n  const restartHealthAttempts = POST_RESTART_HEALTH_ATTEMPTS;\n  const restartWaitSeconds = Math.round(\n    (restartHealthAttempts * POST_RESTART_HEALTH_DELAY_MS) / 1000,\n  );\n\n  await runServiceRestart({\n    service,\n    opts: options,\n    renderStartHints: renderGatewayServiceStartHints,\n    checkTokenDrift: true,\n    onNotLoaded: async () => {\n      const handled = await restartGatewayWithoutServiceManager(restartPort);\n      if (handled) {\n        restartedWithoutServiceManager = true;\n      }\n      return handled;\n    },\n    postRestartCheck: async ({ options: opts, fail }) => {\n      if (!restartedWithoutServiceManager) {\n        return;\n      }\n      const health = await waitForGatewayHealthyListener({\n        port: restartPort,\n        attempts: restartHealthAttempts,\n        delayMs: POST_RESTART_HEALTH_DELAY_MS,\n      });\n      if (health.healthy) {\n        return;\n      }\n      const diagnostics = renderGatewayPortHealthDiagnostics(health);\n      fail(\n        `Gateway restart timed out after ${restartWaitSeconds}s waiting for health checks.`,\n        ['xopc gateway status', 'xopc doctor'],\n        diagnostics,\n        opts,\n      );\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;YAM6D;AAyB7D,MAAM,+BAA+B;AACrC,MAAM,+BAAA;AAEN,eAAe,4BAA4B,SAA8E;AAIvH,QADqB,mBAAkB,OAFf,WAAY,MAAM,uBAAuB,EAC3B,YAAY,QAAQ,IAAI,CAAC,YAAY,KAAK,GAChC,iBAC7B,IAAI,8BAA8B;;AAGvD,SAAS,mCAAmC,MAAwB;AAClE,QAAO,0CAA0C,KAAK,CAAC,QACpD,QAAuB,OAAO,SAAS,IAAI,IAAI,MAAM,EACvD;;AAGH,eAAe,qCAAqC,MAA6B;AAE/E,KAAI,CAAC,iBADU,WAAW,mBAAmB,CACjB,CAAC,CAC3B,OAAM,IAAI,MACR,6GACD;AAGH,KAAI;EACF,MAAM,aAAa,IAAI,iBAAiB;EACxC,MAAM,UAAU,iBAAiB,WAAW,OAAO,EAAE,IAAK;EAC1D,MAAM,WAAW,MAAM,MAAM,oBAAoB,KAAK,cAAc;GAClE,QAAQ;GACR,QAAQ,WAAW;GACpB,CAAC;AACF,eAAa,QAAQ;AACrB,MAAI,CAAC,SAAS,GACZ;SAEI;;AAKV,eAAe,iCAAiC,MAAqD;CACnG,MAAM,OAAO,mCAAmC,KAAK;AACrD,KAAI,KAAK,WAAW,EAClB,QAAO;AAET,MAAK,MAAM,OAAO,KAChB,8BAA6B,KAAK,UAAU;AAE9C,QAAO;EACL,QAAQ;EACR,SAAS,gDAAgD,KAAK,WAAW,IAAI,KAAK,KAAK,WAAW,KAAK,IAAI,qBAAqB,KAAK,CAAC;EACvI;;AAGH,eAAe,oCAAoC,MAAqD;AACtG,OAAM,qCAAqC,KAAK;CAChD,MAAM,OAAO,mCAAmC,KAAK;AACrD,KAAI,KAAK,WAAW,EAClB,QAAO;AAET,KAAI,KAAK,SAAS,EAChB,OAAM,IAAI,MACR,oDAAoD,KAAK,IAAI,qBAAqB,KAAK,CAAC,qDACzF;AAEH,iCAAgC;AAChC,8BAA6B,KAAK,IAAI,UAAU;AAChD,QAAO;EACL,QAAQ;EACR,SAAS,4DAA4D,KAAK,IAAI,KAAK,GAAG;EACvF;;AAGH,eAAsB,cAAc,UAAiD,EAAE,EAAiB;CACtG,MAAM,UAAU,MAAM,uBAAuB;CAC7C,IAAI;AAEJ,OAAM,eAAe;EACnB;EACA,MAAM;EACN,aAAa,YAAY;AACvB,0BAAuB,4BAA4B,QAAQ;AAC3D,UAAO,iCAAiC,MAAM,mBAAmB;;EAEpE,CAAC;;AAGJ,eAAsB,iBAAiB,UAGnC,EAAE,EAAiB;CACrB,MAAM,UAAU,MAAM,uBAAuB;CAC7C,IAAI,iCAAiC;CACrC,MAAM,cAAc,MAAM,4BAA4B,QAAQ;CAC9D,MAAM,wBAAwB;CAC9B,MAAM,qBAAqB,KAAK,MAC7B,wBAAwB,+BAAgC,IAC1D;AAED,OAAM,kBAAkB;EACtB;EACA,MAAM;EACN,kBAAkB;EAClB,iBAAiB;EACjB,aAAa,YAAY;GACvB,MAAM,UAAU,MAAM,oCAAoC,YAAY;AACtE,OAAI,QACF,kCAAiC;AAEnC,UAAO;;EAET,kBAAkB,OAAO,EAAE,SAAS,MAAM,WAAW;AACnD,OAAI,CAAC,+BACH;GAEF,MAAM,SAAS,MAAM,8BAA8B;IACjD,MAAM;IACN,UAAU;IACV,SAAS;IACV,CAAC;AACF,OAAI,OAAO,QACT;GAEF,MAAM,cAAc,mCAAmC,OAAO;AAC9D,QACE,mCAAmC,mBAAmB,+BACtD,CAAC,uBAAuB,cAAc,EACtC,aACA,KACD;;EAEJ,CAAC"}

package/dist/src/cli/commands/gateway/logs.js

@@ -1,4 +1,4 @@
-import { getContextWithOpts } from "../../index.js";
+import { getContextWithOpts } from "../../context.js";
 import { execSync, spawn } from "child_process";
 import { Command } from "commander";
 //#region src/cli/commands/gateway/logs.ts

package/dist/src/cli/commands/gateway/logs.js.map

@@ -1 +1 @@
-{"version":3,"file":"logs.js","names":[],"sources":["../../../../../src/cli/commands/gateway/logs.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { spawn, execSync } from 'child_process';\nimport { getContextWithOpts } from '../../index.js';\n\n/**\n * Create logs subcommand\n */\nexport function createLogsCommand(): Command {\n  return new Command('logs')\n    .description('View gateway logs')\n    .option('--lines <n>', 'Number of lines to show', '50')\n    .option('--follow', 'Follow log output (like tail -f)')\n    .action(async (options) => {\n      const ctx = getContextWithOpts();\n      \n      // Determine log directory from environment or default\n      const logDir = process.env.XOPC_LOG_DIR || \n        `${ctx.configPath.replace('/config.json', '')}/logs`;\n\n      try {\n        if (options.follow) {\n          // Follow mode: use tail -f\n          console.log(`📜 Following gateway logs (Ctrl+C to exit)...\\n`);\n          const tail = spawn('tail', ['-f', '-n', options.lines, `${logDir}/app.log`], {\n            stdio: 'inherit',\n          });\n          \n          tail.on('error', (err) => {\n            console.error('❌ Failed to tail logs:', err.message);\n            process.exit(1);\n          });\n        } else {\n          // Static mode: read last N lines\n          const output = execSync(\n            `tail -n ${options.lines} ${logDir}/app.log 2>/dev/null || echo \"No logs found\"`,\n            { encoding: 'utf-8' }\n          );\n          \n          console.log(`📜 Last ${options.lines} lines of gateway logs:\\n`);\n          console.log(output);\n          process.exit(0);\n        }\n      } catch (err) {\n        console.error('❌ Failed to read logs:', err);\n        process.exit(1);\n      }\n    });\n}\n"],"mappings":";;;;;;;AAOA,SAAgB,oBAA6B;AAC3C,QAAO,IAAI,QAAQ,OAAO,CACvB,YAAY,oBAAoB,CAChC,OAAO,eAAe,2BAA2B,KAAK,CACtD,OAAO,YAAY,mCAAmC,CACtD,OAAO,OAAO,YAAY;EACzB,MAAM,MAAM,oBAAoB;EAGhC,MAAM,SAAS,QAAQ,IAAI,gBACzB,GAAG,IAAI,WAAW,QAAQ,gBAAgB,GAAG,CAAC;AAEhD,MAAI;AACF,OAAI,QAAQ,QAAQ;AAElB,YAAQ,IAAI,kDAAkD;AACjD,UAAM,QAAQ;KAAC;KAAM;KAAM,QAAQ;KAAO,GAAG,OAAO;KAAU,EAAE,EAC3E,OAAO,WACR,CAEG,CAAC,GAAG,UAAU,QAAQ;AACxB,aAAQ,MAAM,0BAA0B,IAAI,QAAQ;AACpD,aAAQ,KAAK,EAAE;MACf;UACG;IAEL,MAAM,SAAS,SACb,WAAW,QAAQ,MAAM,GAAG,OAAO,+CACnC,EAAE,UAAU,SAAS,CACtB;AAED,YAAQ,IAAI,WAAW,QAAQ,MAAM,2BAA2B;AAChE,YAAQ,IAAI,OAAO;AACnB,YAAQ,KAAK,EAAE;;WAEV,KAAK;AACZ,WAAQ,MAAM,0BAA0B,IAAI;AAC5C,WAAQ,KAAK,EAAE;;GAEjB"}
+{"version":3,"file":"logs.js","names":[],"sources":["../../../../../src/cli/commands/gateway/logs.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { spawn, execSync } from 'child_process';\nimport { getContextWithOpts } from '../../context.js';\n\n/**\n * Create logs subcommand\n */\nexport function createLogsCommand(): Command {\n  return new Command('logs')\n    .description('View gateway logs')\n    .option('--lines <n>', 'Number of lines to show', '50')\n    .option('--follow', 'Follow log output (like tail -f)')\n    .action(async (options) => {\n      const ctx = getContextWithOpts();\n      \n      // Determine log directory from environment or default\n      const logDir = process.env.XOPC_LOG_DIR || \n        `${ctx.configPath.replace('/config.json', '')}/logs`;\n\n      try {\n        if (options.follow) {\n          // Follow mode: use tail -f\n          console.log(`📜 Following gateway logs (Ctrl+C to exit)...\\n`);\n          const tail = spawn('tail', ['-f', '-n', options.lines, `${logDir}/app.log`], {\n            stdio: 'inherit',\n          });\n          \n          tail.on('error', (err) => {\n            console.error('❌ Failed to tail logs:', err.message);\n            process.exit(1);\n          });\n        } else {\n          // Static mode: read last N lines\n          const output = execSync(\n            `tail -n ${options.lines} ${logDir}/app.log 2>/dev/null || echo \"No logs found\"`,\n            { encoding: 'utf-8' }\n          );\n          \n          console.log(`📜 Last ${options.lines} lines of gateway logs:\\n`);\n          console.log(output);\n          process.exit(0);\n        }\n      } catch (err) {\n        console.error('❌ Failed to read logs:', err);\n        process.exit(1);\n      }\n    });\n}\n"],"mappings":";;;;;;;AAOA,SAAgB,oBAA6B;AAC3C,QAAO,IAAI,QAAQ,OAAO,CACvB,YAAY,oBAAoB,CAChC,OAAO,eAAe,2BAA2B,KAAK,CACtD,OAAO,YAAY,mCAAmC,CACtD,OAAO,OAAO,YAAY;EACzB,MAAM,MAAM,oBAAoB;EAGhC,MAAM,SAAS,QAAQ,IAAI,gBACzB,GAAG,IAAI,WAAW,QAAQ,gBAAgB,GAAG,CAAC;AAEhD,MAAI;AACF,OAAI,QAAQ,QAAQ;AAElB,YAAQ,IAAI,kDAAkD;AACjD,UAAM,QAAQ;KAAC;KAAM;KAAM,QAAQ;KAAO,GAAG,OAAO;KAAU,EAAE,EAC3E,OAAO,WACR,CAEG,CAAC,GAAG,UAAU,QAAQ;AACxB,aAAQ,MAAM,0BAA0B,IAAI,QAAQ;AACpD,aAAQ,KAAK,EAAE;MACf;UACG;IAEL,MAAM,SAAS,SACb,WAAW,QAAQ,MAAM,GAAG,OAAO,+CACnC,EAAE,UAAU,SAAS,CACtB;AAED,YAAQ,IAAI,WAAW,QAAQ,MAAM,2BAA2B;AAChE,YAAQ,IAAI,OAAO;AACnB,YAAQ,KAAK,EAAE;;WAEV,KAAK;AACZ,WAAQ,MAAM,0BAA0B,IAAI;AAC5C,WAAQ,KAAK,EAAE;;GAEjB"}

package/dist/src/cli/commands/gateway/probe.js

@@ -1,5 +1,5 @@
 import { init_paths, resolveConfigPath } from "../../../config/paths.js";
-import { getContextWithOpts } from "../../index.js";
+import { getContextWithOpts } from "../../context.js";
 import { addGatewayClientOptions, parseGatewayClientOptions } from "../../utils/gateway-client-options.js";
 import { Command } from "commander";
 //#region src/cli/commands/gateway/probe.ts

package/dist/src/cli/commands/gateway/probe.js.map

@@ -1 +1 @@
-{"version":3,"file":"probe.js","names":[],"sources":["../../../../../src/cli/commands/gateway/probe.ts"],"sourcesContent":["import { Command } from 'commander';\n\nimport { resolveConfigPath } from '../../../config/paths.js';\nimport {\n  addGatewayClientOptions,\n  parseGatewayClientOptions,\n} from '../../utils/gateway-client-options.js';\nimport { getContextWithOpts } from '../../index.js';\n\ntype GatewayClientModule = typeof import('../../utils/gateway-client.js');\n\ninterface ProbeTarget {\n  label: string;\n  url: string;\n}\n\ninterface ProbeResultEntry {\n  label: string;\n  url: string;\n  reachable: boolean;\n  authenticated: boolean;\n  durationMs: number;\n  version?: string;\n  error?: string;\n}\n\nfunction resolveProbeTargets(opts: { url?: string; port: number }): ProbeTarget[] {\n  const targets: ProbeTarget[] = [];\n  const port = opts.port;\n  targets.push({ label: 'localhost', url: `http://127.0.0.1:${port}` });\n\n  if (opts.url) {\n    const normalized = opts.url.replace(/\\/+$/, '');\n    if (!normalized.includes('127.0.0.1') && !normalized.includes('localhost')) {\n      targets.push({ label: 'remote', url: normalized });\n    }\n  }\n\n  return targets;\n}\n\nasync function probeTarget(\n  callGatewayApi: GatewayClientModule['callGatewayApi'],\n  target: ProbeTarget,\n  token?: string,\n  timeoutMs?: number,\n): Promise<ProbeResultEntry> {\n  const healthResult = await callGatewayApi<{ status: string; version?: string }>('GET', '/api/health', {\n    url: target.url,\n    timeoutMs: timeoutMs ?? 5000,\n  });\n\n  if (!healthResult.ok) {\n    return {\n      label: target.label,\n      url: target.url,\n      reachable: false,\n      authenticated: false,\n      durationMs: healthResult.durationMs,\n      error: healthResult.error,\n    };\n  }\n\n  let authenticated = false;\n  if (token) {\n    const statusResult = await callGatewayApi('GET', '/api/status', {\n      url: target.url,\n      token,\n      timeoutMs: timeoutMs ?? 5000,\n    });\n    authenticated = statusResult.ok;\n  }\n\n  return {\n    label: target.label,\n    url: target.url,\n    reachable: true,\n    authenticated,\n    durationMs: healthResult.durationMs,\n    version: healthResult.data?.version,\n  };\n}\n\nexport function createProbeCommand(): Command {\n  const cmd = new Command('probe').description('Probe gateway reachability and auth capability');\n\n  addGatewayClientOptions(cmd);\n\n  cmd.action(async (options) => {\n    const ctx = getContextWithOpts();\n    const configPath = ctx.configPath || resolveConfigPath();\n    const [{ loadConfig }, { callGatewayApi, resolveGatewayToken }] = await Promise.all([\n      import('../../../config/index.js'),\n      import('../../utils/gateway-client.js'),\n    ]);\n    const config = loadConfig(configPath);\n    const port = config?.gateway?.port ?? 18790;\n\n    const clientOpts = { ...parseGatewayClientOptions(options as Record<string, unknown>), configPath };\n    const token = resolveGatewayToken(clientOpts);\n    const targets = resolveProbeTargets({ url: clientOpts.url, port });\n    const results: ProbeResultEntry[] = [];\n\n    for (const target of targets) {\n      const result = await probeTarget(callGatewayApi, target, token, clientOpts.timeoutMs);\n      results.push(result);\n    }\n\n    if (clientOpts.json) {\n      console.log(JSON.stringify({ targets: results }, null, 2));\n      const anyReachable = results.some((r) => r.reachable);\n      process.exit(anyReachable ? 0 : 1);\n    }\n\n    console.log('🔍 Gateway Probe');\n    console.log('');\n\n    for (const result of results) {\n      if (result.reachable) {\n        console.log(`✅ ${result.label} (${result.url})`);\n        console.log(`   Reachable: yes (${result.durationMs}ms)`);\n        console.log(\n          `   Auth: ${result.authenticated ? '✅ authenticated' : '🔒 not authenticated (pass --token)'}`,\n        );\n        if (result.version) {\n          console.log(`   Version: ${result.version}`);\n        }\n      } else {\n        console.log(`❌ ${result.label} (${result.url})`);\n        console.log('   Reachable: no');\n        console.log(`   Error: ${result.error}`);\n      }\n      console.log('');\n    }\n\n    const anyReachable = results.some((r) => r.reachable);\n    if (!anyReachable) {\n      console.log('💡 Is the gateway running? Try: xopc gateway');\n    }\n    process.exit(anyReachable ? 0 : 1);\n  });\n\n  return cmd;\n}\n"],"mappings":";;;;;YAE6D;AAwB7D,SAAS,oBAAoB,MAAqD;CAChF,MAAM,UAAyB,EAAE;CACjC,MAAM,OAAO,KAAK;AAClB,SAAQ,KAAK;EAAE,OAAO;EAAa,KAAK,oBAAoB;EAAQ,CAAC;AAErE,KAAI,KAAK,KAAK;EACZ,MAAM,aAAa,KAAK,IAAI,QAAQ,QAAQ,GAAG;AAC/C,MAAI,CAAC,WAAW,SAAS,YAAY,IAAI,CAAC,WAAW,SAAS,YAAY,CACxE,SAAQ,KAAK;GAAE,OAAO;GAAU,KAAK;GAAY,CAAC;;AAItD,QAAO;;AAGT,eAAe,YACb,gBACA,QACA,OACA,WAC2B;CAC3B,MAAM,eAAe,MAAM,eAAqD,OAAO,eAAe;EACpG,KAAK,OAAO;EACZ,WAAW,aAAa;EACzB,CAAC;AAEF,KAAI,CAAC,aAAa,GAChB,QAAO;EACL,OAAO,OAAO;EACd,KAAK,OAAO;EACZ,WAAW;EACX,eAAe;EACf,YAAY,aAAa;EACzB,OAAO,aAAa;EACrB;CAGH,IAAI,gBAAgB;AACpB,KAAI,MAMF,kBAAgB,MALW,eAAe,OAAO,eAAe;EAC9D,KAAK,OAAO;EACZ;EACA,WAAW,aAAa;EACzB,CAAC,EAC2B;AAG/B,QAAO;EACL,OAAO,OAAO;EACd,KAAK,OAAO;EACZ,WAAW;EACX;EACA,YAAY,aAAa;EACzB,SAAS,aAAa,MAAM;EAC7B;;AAGH,SAAgB,qBAA8B;CAC5C,MAAM,MAAM,IAAI,QAAQ,QAAQ,CAAC,YAAY,iDAAiD;AAE9F,yBAAwB,IAAI;AAE5B,KAAI,OAAO,OAAO,YAAY;EAE5B,MAAM,aADM,oBACU,CAAC,cAAc,mBAAmB;EACxD,MAAM,CAAC,EAAE,cAAc,EAAE,gBAAgB,yBAAyB,MAAM,QAAQ,IAAI,CAClF,OAAO,6BACP,OAAO,iCACR,CAAC;EAEF,MAAM,OADS,WAAW,WACP,EAAE,SAAS,QAAQ;EAEtC,MAAM,aAAa;GAAE,GAAG,0BAA0B,QAAmC;GAAE;GAAY;EACnG,MAAM,QAAQ,oBAAoB,WAAW;EAC7C,MAAM,UAAU,oBAAoB;GAAE,KAAK,WAAW;GAAK;GAAM,CAAC;EAClE,MAAM,UAA8B,EAAE;AAEtC,OAAK,MAAM,UAAU,SAAS;GAC5B,MAAM,SAAS,MAAM,YAAY,gBAAgB,QAAQ,OAAO,WAAW,UAAU;AACrF,WAAQ,KAAK,OAAO;;AAGtB,MAAI,WAAW,MAAM;AACnB,WAAQ,IAAI,KAAK,UAAU,EAAE,SAAS,SAAS,EAAE,MAAM,EAAE,CAAC;GAC1D,MAAM,eAAe,QAAQ,MAAM,MAAM,EAAE,UAAU;AACrD,WAAQ,KAAK,eAAe,IAAI,EAAE;;AAGpC,UAAQ,IAAI,mBAAmB;AAC/B,UAAQ,IAAI,GAAG;AAEf,OAAK,MAAM,UAAU,SAAS;AAC5B,OAAI,OAAO,WAAW;AACpB,YAAQ,IAAI,KAAK,OAAO,MAAM,IAAI,OAAO,IAAI,GAAG;AAChD,YAAQ,IAAI,sBAAsB,OAAO,WAAW,KAAK;AACzD,YAAQ,IACN,YAAY,OAAO,gBAAgB,oBAAoB,wCACxD;AACD,QAAI,OAAO,QACT,SAAQ,IAAI,eAAe,OAAO,UAAU;UAEzC;AACL,YAAQ,IAAI,KAAK,OAAO,MAAM,IAAI,OAAO,IAAI,GAAG;AAChD,YAAQ,IAAI,mBAAmB;AAC/B,YAAQ,IAAI,aAAa,OAAO,QAAQ;;AAE1C,WAAQ,IAAI,GAAG;;EAGjB,MAAM,eAAe,QAAQ,MAAM,MAAM,EAAE,UAAU;AACrD,MAAI,CAAC,aACH,SAAQ,IAAI,+CAA+C;AAE7D,UAAQ,KAAK,eAAe,IAAI,EAAE;GAClC;AAEF,QAAO"}
+{"version":3,"file":"probe.js","names":[],"sources":["../../../../../src/cli/commands/gateway/probe.ts"],"sourcesContent":["import { Command } from 'commander';\n\nimport { resolveConfigPath } from '../../../config/paths.js';\nimport {\n  addGatewayClientOptions,\n  parseGatewayClientOptions,\n} from '../../utils/gateway-client-options.js';\nimport { getContextWithOpts } from '../../context.js';\n\ntype GatewayClientModule = typeof import('../../utils/gateway-client.js');\n\ninterface ProbeTarget {\n  label: string;\n  url: string;\n}\n\ninterface ProbeResultEntry {\n  label: string;\n  url: string;\n  reachable: boolean;\n  authenticated: boolean;\n  durationMs: number;\n  version?: string;\n  error?: string;\n}\n\nfunction resolveProbeTargets(opts: { url?: string; port: number }): ProbeTarget[] {\n  const targets: ProbeTarget[] = [];\n  const port = opts.port;\n  targets.push({ label: 'localhost', url: `http://127.0.0.1:${port}` });\n\n  if (opts.url) {\n    const normalized = opts.url.replace(/\\/+$/, '');\n    if (!normalized.includes('127.0.0.1') && !normalized.includes('localhost')) {\n      targets.push({ label: 'remote', url: normalized });\n    }\n  }\n\n  return targets;\n}\n\nasync function probeTarget(\n  callGatewayApi: GatewayClientModule['callGatewayApi'],\n  target: ProbeTarget,\n  token?: string,\n  timeoutMs?: number,\n): Promise<ProbeResultEntry> {\n  const healthResult = await callGatewayApi<{ status: string; version?: string }>('GET', '/api/health', {\n    url: target.url,\n    timeoutMs: timeoutMs ?? 5000,\n  });\n\n  if (!healthResult.ok) {\n    return {\n      label: target.label,\n      url: target.url,\n      reachable: false,\n      authenticated: false,\n      durationMs: healthResult.durationMs,\n      error: healthResult.error,\n    };\n  }\n\n  let authenticated = false;\n  if (token) {\n    const statusResult = await callGatewayApi('GET', '/api/status', {\n      url: target.url,\n      token,\n      timeoutMs: timeoutMs ?? 5000,\n    });\n    authenticated = statusResult.ok;\n  }\n\n  return {\n    label: target.label,\n    url: target.url,\n    reachable: true,\n    authenticated,\n    durationMs: healthResult.durationMs,\n    version: healthResult.data?.version,\n  };\n}\n\nexport function createProbeCommand(): Command {\n  const cmd = new Command('probe').description('Probe gateway reachability and auth capability');\n\n  addGatewayClientOptions(cmd);\n\n  cmd.action(async (options) => {\n    const ctx = getContextWithOpts();\n    const configPath = ctx.configPath || resolveConfigPath();\n    const [{ loadConfig }, { callGatewayApi, resolveGatewayToken }] = await Promise.all([\n      import('../../../config/index.js'),\n      import('../../utils/gateway-client.js'),\n    ]);\n    const config = loadConfig(configPath);\n    const port = config?.gateway?.port ?? 18790;\n\n    const clientOpts = { ...parseGatewayClientOptions(options as Record<string, unknown>), configPath };\n    const token = resolveGatewayToken(clientOpts);\n    const targets = resolveProbeTargets({ url: clientOpts.url, port });\n    const results: ProbeResultEntry[] = [];\n\n    for (const target of targets) {\n      const result = await probeTarget(callGatewayApi, target, token, clientOpts.timeoutMs);\n      results.push(result);\n    }\n\n    if (clientOpts.json) {\n      console.log(JSON.stringify({ targets: results }, null, 2));\n      const anyReachable = results.some((r) => r.reachable);\n      process.exit(anyReachable ? 0 : 1);\n    }\n\n    console.log('🔍 Gateway Probe');\n    console.log('');\n\n    for (const result of results) {\n      if (result.reachable) {\n        console.log(`✅ ${result.label} (${result.url})`);\n        console.log(`   Reachable: yes (${result.durationMs}ms)`);\n        console.log(\n          `   Auth: ${result.authenticated ? '✅ authenticated' : '🔒 not authenticated (pass --token)'}`,\n        );\n        if (result.version) {\n          console.log(`   Version: ${result.version}`);\n        }\n      } else {\n        console.log(`❌ ${result.label} (${result.url})`);\n        console.log('   Reachable: no');\n        console.log(`   Error: ${result.error}`);\n      }\n      console.log('');\n    }\n\n    const anyReachable = results.some((r) => r.reachable);\n    if (!anyReachable) {\n      console.log('💡 Is the gateway running? Try: xopc gateway');\n    }\n    process.exit(anyReachable ? 0 : 1);\n  });\n\n  return cmd;\n}\n"],"mappings":";;;;;YAE6D;AAwB7D,SAAS,oBAAoB,MAAqD;CAChF,MAAM,UAAyB,EAAE;CACjC,MAAM,OAAO,KAAK;AAClB,SAAQ,KAAK;EAAE,OAAO;EAAa,KAAK,oBAAoB;EAAQ,CAAC;AAErE,KAAI,KAAK,KAAK;EACZ,MAAM,aAAa,KAAK,IAAI,QAAQ,QAAQ,GAAG;AAC/C,MAAI,CAAC,WAAW,SAAS,YAAY,IAAI,CAAC,WAAW,SAAS,YAAY,CACxE,SAAQ,KAAK;GAAE,OAAO;GAAU,KAAK;GAAY,CAAC;;AAItD,QAAO;;AAGT,eAAe,YACb,gBACA,QACA,OACA,WAC2B;CAC3B,MAAM,eAAe,MAAM,eAAqD,OAAO,eAAe;EACpG,KAAK,OAAO;EACZ,WAAW,aAAa;EACzB,CAAC;AAEF,KAAI,CAAC,aAAa,GAChB,QAAO;EACL,OAAO,OAAO;EACd,KAAK,OAAO;EACZ,WAAW;EACX,eAAe;EACf,YAAY,aAAa;EACzB,OAAO,aAAa;EACrB;CAGH,IAAI,gBAAgB;AACpB,KAAI,MAMF,kBAAgB,MALW,eAAe,OAAO,eAAe;EAC9D,KAAK,OAAO;EACZ;EACA,WAAW,aAAa;EACzB,CAAC,EAC2B;AAG/B,QAAO;EACL,OAAO,OAAO;EACd,KAAK,OAAO;EACZ,WAAW;EACX;EACA,YAAY,aAAa;EACzB,SAAS,aAAa,MAAM;EAC7B;;AAGH,SAAgB,qBAA8B;CAC5C,MAAM,MAAM,IAAI,QAAQ,QAAQ,CAAC,YAAY,iDAAiD;AAE9F,yBAAwB,IAAI;AAE5B,KAAI,OAAO,OAAO,YAAY;EAE5B,MAAM,aADM,oBACU,CAAC,cAAc,mBAAmB;EACxD,MAAM,CAAC,EAAE,cAAc,EAAE,gBAAgB,yBAAyB,MAAM,QAAQ,IAAI,CAClF,OAAO,6BACP,OAAO,iCACR,CAAC;EAEF,MAAM,OADS,WAAW,WACP,EAAE,SAAS,QAAQ;EAEtC,MAAM,aAAa;GAAE,GAAG,0BAA0B,QAAmC;GAAE;GAAY;EACnG,MAAM,QAAQ,oBAAoB,WAAW;EAC7C,MAAM,UAAU,oBAAoB;GAAE,KAAK,WAAW;GAAK;GAAM,CAAC;EAClE,MAAM,UAA8B,EAAE;AAEtC,OAAK,MAAM,UAAU,SAAS;GAC5B,MAAM,SAAS,MAAM,YAAY,gBAAgB,QAAQ,OAAO,WAAW,UAAU;AACrF,WAAQ,KAAK,OAAO;;AAGtB,MAAI,WAAW,MAAM;AACnB,WAAQ,IAAI,KAAK,UAAU,EAAE,SAAS,SAAS,EAAE,MAAM,EAAE,CAAC;GAC1D,MAAM,eAAe,QAAQ,MAAM,MAAM,EAAE,UAAU;AACrD,WAAQ,KAAK,eAAe,IAAI,EAAE;;AAGpC,UAAQ,IAAI,mBAAmB;AAC/B,UAAQ,IAAI,GAAG;AAEf,OAAK,MAAM,UAAU,SAAS;AAC5B,OAAI,OAAO,WAAW;AACpB,YAAQ,IAAI,KAAK,OAAO,MAAM,IAAI,OAAO,IAAI,GAAG;AAChD,YAAQ,IAAI,sBAAsB,OAAO,WAAW,KAAK;AACzD,YAAQ,IACN,YAAY,OAAO,gBAAgB,oBAAoB,wCACxD;AACD,QAAI,OAAO,QACT,SAAQ,IAAI,eAAe,OAAO,UAAU;UAEzC;AACL,YAAQ,IAAI,KAAK,OAAO,MAAM,IAAI,OAAO,IAAI,GAAG;AAChD,YAAQ,IAAI,mBAAmB;AAC/B,YAAQ,IAAI,aAAa,OAAO,QAAQ;;AAE1C,WAAQ,IAAI,GAAG;;EAGjB,MAAM,eAAe,QAAQ,MAAM,MAAM,EAAE,UAAU;AACrD,MAAI,CAAC,aACH,SAAQ,IAAI,+CAA+C;AAE7D,UAAQ,KAAK,eAAe,IAAI,EAAE;GAClC;AAEF,QAAO"}

package/dist/src/cli/commands/gateway/restart-health.d.ts

@@ -11,6 +11,7 @@ import type { GatewayServiceRuntime } from '../../../daemon/types.js';
 import type { PortUsage } from '../../../infra/ports.js';
 export declare const DEFAULT_RESTART_HEALTH_TIMEOUT_MS = 60000;
 export declare const DEFAULT_RESTART_HEALTH_DELAY_MS = 500;
+export declare const DEFAULT_RESTART_HEALTH_ATTEMPTS: number;
 export type GatewayRestartWaitOutcome = 'healthy' | 'version-mismatch' | 'stale-pids' | 'stopped-free' | 'timeout';
 export interface GatewayRestartSnapshot {
     runtime?: GatewayServiceRuntime;
@@ -47,4 +48,15 @@ export declare function waitForRestartHealth(params: {
     token?: string;
     onProgress?: (snapshot: GatewayRestartSnapshot) => void;
 }): Promise<GatewayRestartSnapshot>;
+export type GatewayPortHealthSnapshot = {
+    portUsage?: PortUsage;
+    healthy: boolean;
+};
+export declare function waitForGatewayHealthyListener(params: {
+    port: number;
+    attempts?: number;
+    delayMs?: number;
+    token?: string;
+}): Promise<GatewayPortHealthSnapshot>;
+export declare function renderGatewayPortHealthDiagnostics(snapshot: GatewayPortHealthSnapshot): string[];
 export {};