@xopcai/xopc 0.0.88 → 0.0.90

package/dist/src/infra/update-global.js

@@ -1,9 +1,13 @@
+import { resolveExecPathBinPrepend } from "./path-env.js";
+import { readPackageVersion } from "./package-json.js";
+import { applyPathPrepend } from "./path-prepend.js";
 import { createDefaultCommandRunner } from "./run-command.js";
 import fs from "node:fs";
 import fs$1 from "node:fs/promises";
 import path from "node:path";
 //#region src/infra/update-global.ts
 const XOPC_PACKAGE_NAME = "@xopcai/xopc";
+const GLOBAL_RENAME_PREFIX = ".";
 const COREPACK_ENABLE_DOWNLOAD_PROMPT_DEFAULT = "0";
 const NPM_GLOBAL_INSTALL_QUIET_FLAGS = [
 	"--no-fund",
@@ -12,7 +16,6 @@ const NPM_GLOBAL_INSTALL_QUIET_FLAGS = [
 ];
 const NPM_GLOBAL_INSTALL_OMIT_OPTIONAL_FLAGS = ["--omit=optional", ...NPM_GLOBAL_INSTALL_QUIET_FLAGS];
 const GLOBAL_DETECT_TIMEOUT_MS = 15e3;
-const GLOBAL_INSTALL_TIMEOUT_MS = 2700 * 1e3;
 async function pathExists(targetPath) {
 	try {
 		await fs$1.access(targetPath);
@@ -48,9 +51,16 @@ function resolvePreferredNpmCommand(pkgRoot) {
 	const candidate = process.platform === "win32" ? path.join(prefix, "npm.cmd") : path.join(prefix, "bin", "npm");
 	return fs.existsSync(candidate) ? candidate : null;
 }
+function resolveNpmFromExecPath() {
+	const execPath = process.execPath?.trim();
+	if (!execPath) return null;
+	const binDir = path.dirname(execPath);
+	const candidate = process.platform === "win32" ? path.join(binDir, "npm.cmd") : path.join(binDir, "npm");
+	return fs.existsSync(candidate) ? candidate : null;
+}
 function resolvePreferredGlobalManagerCommand(manager, pkgRoot) {
 	if (manager !== "npm") return manager;
-	return resolvePreferredNpmCommand(pkgRoot) ?? manager;
+	return resolvePreferredNpmCommand(pkgRoot) ?? resolveNpmFromExecPath() ?? manager;
 }
 function resolveGlobalInstallCommand(manager, pkgRoot) {
 	return {
@@ -61,6 +71,40 @@ function resolveGlobalInstallCommand(manager, pkgRoot) {
 function normalizeGlobalInstallCommand(managerOrCommand, pkgRoot) {
 	return typeof managerOrCommand === "string" ? resolveGlobalInstallCommand(managerOrCommand, pkgRoot) : managerOrCommand;
 }
+function resolveNpmGlobalPrefixLayoutFromGlobalRoot(globalRoot) {
+	const trimmed = globalRoot?.trim();
+	if (!trimmed) return null;
+	const normalized = path.resolve(trimmed);
+	if (path.basename(normalized) !== "node_modules") return null;
+	const parentDir = path.dirname(normalized);
+	if (path.basename(parentDir) === "lib") {
+		const prefix = path.dirname(parentDir);
+		return {
+			prefix,
+			globalRoot: normalized,
+			binDir: path.join(prefix, "bin")
+		};
+	}
+	if (process.platform === "win32") return {
+		prefix: parentDir,
+		globalRoot: normalized,
+		binDir: parentDir
+	};
+	return null;
+}
+function resolveNpmGlobalPrefixLayoutFromPrefix(prefix) {
+	const resolvedPrefix = path.resolve(prefix);
+	if (process.platform === "win32") return {
+		prefix: resolvedPrefix,
+		globalRoot: path.join(resolvedPrefix, "node_modules"),
+		binDir: resolvedPrefix
+	};
+	return {
+		prefix: resolvedPrefix,
+		globalRoot: path.join(resolvedPrefix, "lib", "node_modules"),
+		binDir: path.join(resolvedPrefix, "bin")
+	};
+}
 function applyWindowsPackageInstallEnv(env) {
 	if (process.platform !== "win32") return;
 	env.NPM_CONFIG_UPDATE_NOTIFIER = "false";
@@ -71,10 +115,12 @@ function applyCorepackDownloadPromptEnv(env) {
 	if (!env.COREPACK_ENABLE_DOWNLOAD_PROMPT?.trim()) env.COREPACK_ENABLE_DOWNLOAD_PROMPT = COREPACK_ENABLE_DOWNLOAD_PROMPT_DEFAULT;
 }
 async function createGlobalInstallEnv(env) {
+	const pathPrepend = resolveExecPathBinPrepend();
 	const sourceEnv = env ?? process.env;
 	const hasCorepack = Boolean(sourceEnv.COREPACK_ENABLE_DOWNLOAD_PROMPT?.trim());
-	if (process.platform !== "win32" && hasCorepack) return env;
+	if (process.platform !== "win32" && hasCorepack && pathPrepend.length === 0) return env;
 	const merged = Object.fromEntries(Object.entries(sourceEnv).filter(([, value]) => value != null).map(([key, value]) => [key, String(value)]));
+	applyPathPrepend(merged, pathPrepend);
 	applyWindowsPackageInstallEnv(merged);
 	applyCorepackDownloadPromptEnv(merged);
 	return merged;
@@ -84,6 +130,20 @@ function resolveGlobalInstallSpec(params) {
 	if (override) return override;
 	return `${XOPC_PACKAGE_NAME}@${params.version}`;
 }
+function resolveExpectedInstalledVersionFromSpec(spec) {
+	const normalized = spec.trim();
+	if (!normalized.startsWith(`@xopcai/xopc@`)) return null;
+	const rawVersion = normalized.slice(13).trim();
+	if (!rawVersion || rawVersion.includes("/") || rawVersion.includes(":") || rawVersion.includes("#") || /^(latest|beta|next|dev)$/i.test(rawVersion)) return null;
+	return rawVersion;
+}
+async function collectInstalledGlobalPackageErrors(params) {
+	const errors = [];
+	const installedVersion = await readPackageVersion(params.packageRoot);
+	if (params.expectedVersion && installedVersion !== params.expectedVersion) errors.push(`expected installed version ${params.expectedVersion}, found ${installedVersion ?? "<missing>"}`);
+	if (!installedVersion) errors.push("missing package.json version");
+	return errors;
+}
 async function resolveGlobalRoot(managerOrCommand, runCommand, timeoutMs, pkgRoot) {
 	const res = await runCommand([
 		normalizeGlobalInstallCommand(managerOrCommand, pkgRoot).command,
@@ -93,7 +153,21 @@ async function resolveGlobalRoot(managerOrCommand, runCommand, timeoutMs, pkgRoo
 	if (!res || res.code !== 0) return null;
 	return res.stdout.trim() || null;
 }
-function globalInstallArgs(managerOrCommand, spec, pkgRoot) {
+async function resolveGlobalPackageRoot(managerOrCommand, runCommand, timeoutMs, pkgRoot) {
+	const root = await resolveGlobalRoot(managerOrCommand, runCommand, timeoutMs, pkgRoot);
+	if (!root) return null;
+	return joinGlobalPackagePath(root);
+}
+async function resolveGlobalInstallTarget(params) {
+	const command = normalizeGlobalInstallCommand(params.manager, params.pkgRoot);
+	const globalRoot = await resolveGlobalRoot(command, params.runCommand, params.timeoutMs, params.pkgRoot);
+	return {
+		...command,
+		globalRoot,
+		packageRoot: globalRoot ? joinGlobalPackagePath(globalRoot) : null
+	};
+}
+function globalInstallArgs(managerOrCommand, spec, pkgRoot, installPrefix) {
 	const resolved = normalizeGlobalInstallCommand(managerOrCommand, pkgRoot);
 	if (resolved.manager === "pnpm") return [
 		resolved.command,
@@ -105,27 +179,55 @@ function globalInstallArgs(managerOrCommand, spec, pkgRoot) {
 		resolved.command,
 		"install",
 		"-g",
+		...installPrefix ? ["--prefix", installPrefix] : [],
 		spec,
 		...NPM_GLOBAL_INSTALL_QUIET_FLAGS
 	];
 }
-function globalInstallFallbackArgs(managerOrCommand, spec, pkgRoot) {
+function globalInstallFallbackArgs(managerOrCommand, spec, pkgRoot, installPrefix) {
 	const resolved = normalizeGlobalInstallCommand(managerOrCommand, pkgRoot);
 	if (resolved.manager !== "npm") return null;
 	return [
 		resolved.command,
 		"install",
 		"-g",
+		...installPrefix ? ["--prefix", installPrefix] : [],
 		spec,
 		...NPM_GLOBAL_INSTALL_OMIT_OPTIONAL_FLAGS
 	];
 }
+async function cleanupGlobalRenameDirs(params) {
+	const removed = [];
+	const root = params.globalRoot.trim();
+	const name = params.packageName.trim();
+	if (!root || !name) return { removed };
+	const prefix = `${GLOBAL_RENAME_PREFIX}${name}-`;
+	let entries = [];
+	try {
+		entries = await fs$1.readdir(root);
+	} catch {
+		return { removed };
+	}
+	for (const entry of entries) {
+		if (!entry.startsWith(prefix)) continue;
+		const target = path.join(root, entry);
+		try {
+			if (!(await fs$1.lstat(target)).isDirectory()) continue;
+			await fs$1.rm(target, {
+				recursive: true,
+				force: true
+			});
+			removed.push(entry);
+		} catch {}
+	}
+	return { removed };
+}
 async function detectGlobalInstallManagerForRoot(runCommand, pkgRoot, timeoutMs) {
 	const pkgReal = await tryRealpath(pkgRoot);
-	for (const { manager, argv } of [{
+	const candidates = [{
 		manager: "npm",
 		argv: [
-			"npm",
+			resolvePreferredGlobalManagerCommand("npm", pkgRoot),
 			"root",
 			"-g"
 		]
@@ -136,7 +238,8 @@ async function detectGlobalInstallManagerForRoot(runCommand, pkgRoot, timeoutMs)
 			"root",
 			"-g"
 		]
-	}]) {
+	}];
+	for (const { manager, argv } of candidates) {
 		const res = await runCommand(argv, { timeoutMs }).catch(() => null);
 		if (!res || res.code !== 0) continue;
 		const globalRoot = res.stdout.trim();
@@ -144,7 +247,7 @@ async function detectGlobalInstallManagerForRoot(runCommand, pkgRoot, timeoutMs)
 		const expectedReal = await tryRealpath(joinGlobalPackagePath(await tryRealpath(globalRoot)));
 		if (path.resolve(expectedReal) === path.resolve(pkgReal)) return manager;
 	}
-	if (resolvePreferredNpmCommand(pkgRoot)) return "npm";
+	if (resolvePreferredNpmCommand(pkgRoot) || resolveNpmFromExecPath()) return "npm";
 	return null;
 }
 async function detectGlobalInstallManagerByPresence(runCommand, timeoutMs) {
@@ -164,61 +267,7 @@ async function resolveGlobalManager(params) {
 	}
 	return await detectGlobalInstallManagerByPresence(runCommand, timeoutMs) ?? "npm";
 }
-function tailOutput(text, max = 4e3) {
-	const t = text.trim();
-	if (t.length <= max) return t;
-	return t.slice(-max);
-}
-async function runGlobalPackageInstall(params) {
-	const timeoutMs = params.timeoutMs ?? GLOBAL_INSTALL_TIMEOUT_MS;
-	const runCommand = createDefaultCommandRunner();
-	const installEnv = await createGlobalInstallEnv();
-	const runStep = async (argv) => {
-		const result = await runCommand(argv, {
-			timeoutMs,
-			env: installEnv
-		});
-		if (params.echoToTerminal) {
-			if (result.stdout) process.stdout.write(result.stdout);
-			if (result.stderr) process.stderr.write(result.stderr);
-		}
-		return result;
-	};
-	const primary = await runStep(globalInstallArgs(params.manager, params.spec, params.pkgRoot));
-	if (primary.code === 0) return {
-		exitCode: 0,
-		stdout: primary.stdout,
-		stderr: primary.stderr,
-		packageManager: params.manager,
-		usedFallback: false
-	};
-	const fallbackArgv = globalInstallFallbackArgs(params.manager, params.spec, params.pkgRoot);
-	if (!fallbackArgv) return {
-		exitCode: primary.code ?? 1,
-		stdout: primary.stdout,
-		stderr: primary.stderr,
-		packageManager: params.manager,
-		usedFallback: false
-	};
-	const fallback = await runStep(fallbackArgv);
-	return {
-		exitCode: fallback.code ?? 1,
-		stdout: [primary.stdout, fallback.stdout].filter(Boolean).join("\n"),
-		stderr: [primary.stderr, fallback.stderr].filter(Boolean).join("\n"),
-		packageManager: params.manager,
-		usedFallback: true
-	};
-}
-function formatGlobalInstallFailure(params) {
-	const tail = tailOutput(params.stderr);
-	return [
-		`Global install via ${params.packageManager} failed (exit ${params.exitCode}).`,
-		params.usedFallback ? "Retried with --omit=optional." : null,
-		`Try manually: ${params.packageManager} install -g ${params.spec}`,
-		tail ? `Install output:\n${tail}` : null
-	].filter(Boolean).join("\n");
-}
 //#endregion
-export { XOPC_PACKAGE_NAME, createGlobalInstallEnv, detectGlobalInstallManagerByPresence, detectGlobalInstallManagerForRoot, formatGlobalInstallFailure, globalInstallArgs, globalInstallFallbackArgs, joinGlobalPackagePath, resolveGlobalInstallCommand, resolveGlobalInstallSpec, resolveGlobalManager, resolveGlobalRoot, runGlobalPackageInstall };
+export { XOPC_PACKAGE_NAME, cleanupGlobalRenameDirs, collectInstalledGlobalPackageErrors, createGlobalInstallEnv, detectGlobalInstallManagerByPresence, detectGlobalInstallManagerForRoot, globalInstallArgs, globalInstallFallbackArgs, joinGlobalPackagePath, resolveExpectedInstalledVersionFromSpec, resolveGlobalInstallCommand, resolveGlobalInstallSpec, resolveGlobalInstallTarget, resolveGlobalManager, resolveGlobalPackageRoot, resolveGlobalRoot, resolveNpmGlobalPrefixLayoutFromGlobalRoot, resolveNpmGlobalPrefixLayoutFromPrefix };
 
 //# sourceMappingURL=update-global.js.map

package/dist/src/infra/update-global.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-global.js","names":["fs","fsSync"],"sources":["../../../src/infra/update-global.ts"],"sourcesContent":["// src/infra/update-global.ts — global npm/pnpm install detection and commands (OpenClaw-aligned)\n\nimport fsSync from 'node:fs';\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport {\n  createDefaultCommandRunner,\n  type CommandRunner,\n  type CommandRunResult,\n} from './run-command.js';\n\nexport const XOPC_PACKAGE_NAME = '@xopcai/xopc';\n\nexport type GlobalInstallManager = 'npm' | 'pnpm';\n\nexport type ResolvedGlobalInstallCommand = {\n  manager: GlobalInstallManager;\n  command: string;\n};\n\nconst COREPACK_ENABLE_DOWNLOAD_PROMPT_DEFAULT = '0';\nconst NPM_GLOBAL_INSTALL_QUIET_FLAGS = ['--no-fund', '--no-audit', '--loglevel=error'] as const;\nconst NPM_GLOBAL_INSTALL_OMIT_OPTIONAL_FLAGS = [\n  '--omit=optional',\n  ...NPM_GLOBAL_INSTALL_QUIET_FLAGS,\n] as const;\n\nconst GLOBAL_DETECT_TIMEOUT_MS = 15_000;\nconst GLOBAL_INSTALL_TIMEOUT_MS = 45 * 60 * 1000;\n\nexport type GlobalInstallRunResult = {\n  exitCode: number;\n  stdout: string;\n  stderr: string;\n  packageManager: GlobalInstallManager;\n  usedFallback: boolean;\n};\n\nasync function pathExists(targetPath: string): Promise<boolean> {\n  try {\n    await fs.access(targetPath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function tryRealpath(targetPath: string): Promise<string> {\n  try {\n    return await fs.realpath(targetPath);\n  } catch {\n    return path.resolve(targetPath);\n  }\n}\n\nexport function joinGlobalPackagePath(globalRoot: string): string {\n  return path.join(globalRoot, XOPC_PACKAGE_NAME);\n}\n\nfunction inferNpmPrefixFromPackageRoot(pkgRoot?: string | null): string | null {\n  const trimmed = pkgRoot?.trim();\n  if (!trimmed) return null;\n  const normalized = path.resolve(trimmed);\n  const nodeModulesDir = path.dirname(normalized);\n  if (path.basename(nodeModulesDir) !== 'node_modules') return null;\n  const parentDir = path.dirname(nodeModulesDir);\n  if (path.basename(parentDir) === 'lib') {\n    return path.dirname(parentDir);\n  }\n  if (process.platform === 'win32' && path.basename(parentDir).toLowerCase() === 'npm') {\n    return parentDir;\n  }\n  return null;\n}\n\nfunction resolvePreferredNpmCommand(pkgRoot?: string | null): string | null {\n  const prefix = inferNpmPrefixFromPackageRoot(pkgRoot);\n  if (!prefix) return null;\n  const candidate =\n    process.platform === 'win32' ? path.join(prefix, 'npm.cmd') : path.join(prefix, 'bin', 'npm');\n  return fsSync.existsSync(candidate) ? candidate : null;\n}\n\nfunction resolvePreferredGlobalManagerCommand(\n  manager: GlobalInstallManager,\n  pkgRoot?: string | null,\n): string {\n  if (manager !== 'npm') return manager;\n  return resolvePreferredNpmCommand(pkgRoot) ?? manager;\n}\n\nexport function resolveGlobalInstallCommand(\n  manager: GlobalInstallManager,\n  pkgRoot?: string | null,\n): ResolvedGlobalInstallCommand {\n  return {\n    manager,\n    command: resolvePreferredGlobalManagerCommand(manager, pkgRoot),\n  };\n}\n\nfunction normalizeGlobalInstallCommand(\n  managerOrCommand: GlobalInstallManager | ResolvedGlobalInstallCommand,\n  pkgRoot?: string | null,\n): ResolvedGlobalInstallCommand {\n  return typeof managerOrCommand === 'string'\n    ? resolveGlobalInstallCommand(managerOrCommand, pkgRoot)\n    : managerOrCommand;\n}\n\nfunction applyWindowsPackageInstallEnv(env: Record<string, string>): void {\n  if (process.platform !== 'win32') return;\n  env.NPM_CONFIG_UPDATE_NOTIFIER = 'false';\n  env.NPM_CONFIG_FUND = 'false';\n  env.NPM_CONFIG_AUDIT = 'false';\n}\n\nfunction applyCorepackDownloadPromptEnv(env: Record<string, string>): void {\n  if (!env.COREPACK_ENABLE_DOWNLOAD_PROMPT?.trim()) {\n    env.COREPACK_ENABLE_DOWNLOAD_PROMPT = COREPACK_ENABLE_DOWNLOAD_PROMPT_DEFAULT;\n  }\n}\n\nexport async function createGlobalInstallEnv(\n  env?: NodeJS.ProcessEnv,\n): Promise<NodeJS.ProcessEnv | undefined> {\n  const sourceEnv = env ?? process.env;\n  const hasCorepack = Boolean(sourceEnv.COREPACK_ENABLE_DOWNLOAD_PROMPT?.trim());\n  if (process.platform !== 'win32' && hasCorepack) {\n    return env;\n  }\n  const merged = Object.fromEntries(\n    Object.entries(sourceEnv)\n      .filter(([, value]) => value != null)\n      .map(([key, value]) => [key, String(value)]),\n  ) as Record<string, string>;\n  applyWindowsPackageInstallEnv(merged);\n  applyCorepackDownloadPromptEnv(merged);\n  return merged;\n}\n\nexport function resolveGlobalInstallSpec(params: {\n  version: string;\n  env?: NodeJS.ProcessEnv;\n}): string {\n  const override =\n    params.env?.XOPC_UPDATE_PACKAGE_SPEC?.trim() || process.env.XOPC_UPDATE_PACKAGE_SPEC?.trim();\n  if (override) return override;\n  return `${XOPC_PACKAGE_NAME}@${params.version}`;\n}\n\nexport async function resolveGlobalRoot(\n  managerOrCommand: GlobalInstallManager | ResolvedGlobalInstallCommand,\n  runCommand: CommandRunner,\n  timeoutMs: number,\n  pkgRoot?: string | null,\n): Promise<string | null> {\n  const resolved = normalizeGlobalInstallCommand(managerOrCommand, pkgRoot);\n  const argv = [resolved.command, 'root', '-g'];\n  const res = await runCommand(argv, { timeoutMs }).catch(() => null);\n  if (!res || res.code !== 0) return null;\n  const root = res.stdout.trim();\n  return root || null;\n}\n\nexport function globalInstallArgs(\n  managerOrCommand: GlobalInstallManager | ResolvedGlobalInstallCommand,\n  spec: string,\n  pkgRoot?: string | null,\n): string[] {\n  const resolved = normalizeGlobalInstallCommand(managerOrCommand, pkgRoot);\n  if (resolved.manager === 'pnpm') {\n    return [resolved.command, 'add', '-g', spec];\n  }\n  return [resolved.command, 'install', '-g', spec, ...NPM_GLOBAL_INSTALL_QUIET_FLAGS];\n}\n\nexport function globalInstallFallbackArgs(\n  managerOrCommand: GlobalInstallManager | ResolvedGlobalInstallCommand,\n  spec: string,\n  pkgRoot?: string | null,\n): string[] | null {\n  const resolved = normalizeGlobalInstallCommand(managerOrCommand, pkgRoot);\n  if (resolved.manager !== 'npm') return null;\n  return [resolved.command, 'install', '-g', spec, ...NPM_GLOBAL_INSTALL_OMIT_OPTIONAL_FLAGS];\n}\n\nexport async function detectGlobalInstallManagerForRoot(\n  runCommand: CommandRunner,\n  pkgRoot: string,\n  timeoutMs: number,\n): Promise<GlobalInstallManager | null> {\n  const pkgReal = await tryRealpath(pkgRoot);\n\n  const candidates: Array<{ manager: GlobalInstallManager; argv: string[] }> = [\n    { manager: 'npm', argv: ['npm', 'root', '-g'] },\n    { manager: 'pnpm', argv: ['pnpm', 'root', '-g'] },\n  ];\n\n  for (const { manager, argv } of candidates) {\n    const res = await runCommand(argv, { timeoutMs }).catch(() => null);\n    if (!res || res.code !== 0) continue;\n    const globalRoot = res.stdout.trim();\n    if (!globalRoot) continue;\n    const globalReal = await tryRealpath(globalRoot);\n    const expected = joinGlobalPackagePath(globalReal);\n    const expectedReal = await tryRealpath(expected);\n    if (path.resolve(expectedReal) === path.resolve(pkgReal)) {\n      return manager;\n    }\n  }\n\n  if (resolvePreferredNpmCommand(pkgRoot)) {\n    return 'npm';\n  }\n\n  return null;\n}\n\nexport async function detectGlobalInstallManagerByPresence(\n  runCommand: CommandRunner,\n  timeoutMs: number,\n): Promise<GlobalInstallManager | null> {\n  for (const manager of ['npm', 'pnpm'] as const) {\n    const root = await resolveGlobalRoot(manager, runCommand, timeoutMs);\n    if (!root) continue;\n    if (await pathExists(joinGlobalPackagePath(root))) {\n      return manager;\n    }\n  }\n  return null;\n}\n\nexport async function resolveGlobalManager(params: {\n  root: string | null;\n  timeoutMs?: number;\n}): Promise<GlobalInstallManager> {\n  const runCommand = createDefaultCommandRunner();\n  const timeoutMs = params.timeoutMs ?? GLOBAL_DETECT_TIMEOUT_MS;\n\n  if (params.root) {\n    const detected = await detectGlobalInstallManagerForRoot(runCommand, params.root, timeoutMs);\n    if (detected) return detected;\n  }\n\n  const byPresence = await detectGlobalInstallManagerByPresence(runCommand, timeoutMs);\n  return byPresence ?? 'npm';\n}\n\nfunction tailOutput(text: string, max = 4000): string {\n  const t = text.trim();\n  if (t.length <= max) return t;\n  return t.slice(-max);\n}\n\nexport async function runGlobalPackageInstall(params: {\n  manager: GlobalInstallManager;\n  spec: string;\n  pkgRoot: string | null;\n  timeoutMs?: number;\n  /** Echo install output to the parent process (CLI interactive). */\n  echoToTerminal?: boolean;\n}): Promise<GlobalInstallRunResult> {\n  const timeoutMs = params.timeoutMs ?? GLOBAL_INSTALL_TIMEOUT_MS;\n  const runCommand = createDefaultCommandRunner();\n  const installEnv = await createGlobalInstallEnv();\n\n  const runStep = async (argv: string[]): Promise<CommandRunResult> => {\n    const result = await runCommand(argv, { timeoutMs, env: installEnv });\n    if (params.echoToTerminal) {\n      if (result.stdout) process.stdout.write(result.stdout);\n      if (result.stderr) process.stderr.write(result.stderr);\n    }\n    return result;\n  };\n\n  const primaryArgv = globalInstallArgs(params.manager, params.spec, params.pkgRoot);\n  const primary = await runStep(primaryArgv);\n  if (primary.code === 0) {\n    return {\n      exitCode: 0,\n      stdout: primary.stdout,\n      stderr: primary.stderr,\n      packageManager: params.manager,\n      usedFallback: false,\n    };\n  }\n\n  const fallbackArgv = globalInstallFallbackArgs(params.manager, params.spec, params.pkgRoot);\n  if (!fallbackArgv) {\n    return {\n      exitCode: primary.code ?? 1,\n      stdout: primary.stdout,\n      stderr: primary.stderr,\n      packageManager: params.manager,\n      usedFallback: false,\n    };\n  }\n\n  const fallback = await runStep(fallbackArgv);\n  return {\n    exitCode: fallback.code ?? 1,\n    stdout: [primary.stdout, fallback.stdout].filter(Boolean).join('\\n'),\n    stderr: [primary.stderr, fallback.stderr].filter(Boolean).join('\\n'),\n    packageManager: params.manager,\n    usedFallback: true,\n  };\n}\n\nexport function formatGlobalInstallFailure(params: {\n  packageManager: GlobalInstallManager;\n  spec: string;\n  exitCode: number;\n  stderr: string;\n  usedFallback: boolean;\n}): string {\n  const tail = tailOutput(params.stderr);\n  const parts = [\n    `Global install via ${params.packageManager} failed (exit ${params.exitCode}).`,\n    params.usedFallback ? 'Retried with --omit=optional.' : null,\n    `Try manually: ${params.packageManager} install -g ${params.spec}`,\n    tail ? `Install output:\\n${tail}` : null,\n  ].filter(Boolean);\n  return parts.join('\\n');\n}\n"],"mappings":"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"}
+{"version":3,"file":"update-global.js","names":["fs","fsSync"],"sources":["../../../src/infra/update-global.ts"],"sourcesContent":["// src/infra/update-global.ts — global npm/pnpm install detection and commands (OpenClaw-aligned)\n\nimport fsSync from 'node:fs';\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { applyPathPrepend } from './path-prepend.js';\nimport { resolveExecPathBinPrepend } from './path-env.js';\nimport { readPackageVersion } from './package-json.js';\nimport { createDefaultCommandRunner, type CommandRunner } from './run-command.js';\n\nexport const XOPC_PACKAGE_NAME = '@xopcai/xopc';\n\nexport type GlobalInstallManager = 'npm' | 'pnpm';\n\nexport type ResolvedGlobalInstallCommand = {\n  manager: GlobalInstallManager;\n  command: string;\n};\n\nexport type ResolvedGlobalInstallTarget = ResolvedGlobalInstallCommand & {\n  globalRoot: string | null;\n  packageRoot: string | null;\n};\n\nexport type NpmGlobalPrefixLayout = {\n  prefix: string;\n  globalRoot: string;\n  binDir: string;\n};\n\nconst GLOBAL_RENAME_PREFIX = '.';\nconst COREPACK_ENABLE_DOWNLOAD_PROMPT_DEFAULT = '0';\nconst NPM_GLOBAL_INSTALL_QUIET_FLAGS = ['--no-fund', '--no-audit', '--loglevel=error'] as const;\nconst NPM_GLOBAL_INSTALL_OMIT_OPTIONAL_FLAGS = [\n  '--omit=optional',\n  ...NPM_GLOBAL_INSTALL_QUIET_FLAGS,\n] as const;\n\nconst GLOBAL_DETECT_TIMEOUT_MS = 15_000;\n\nasync function pathExists(targetPath: string): Promise<boolean> {\n  try {\n    await fs.access(targetPath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function tryRealpath(targetPath: string): Promise<string> {\n  try {\n    return await fs.realpath(targetPath);\n  } catch {\n    return path.resolve(targetPath);\n  }\n}\n\nexport function joinGlobalPackagePath(globalRoot: string): string {\n  return path.join(globalRoot, XOPC_PACKAGE_NAME);\n}\n\nfunction inferNpmPrefixFromPackageRoot(pkgRoot?: string | null): string | null {\n  const trimmed = pkgRoot?.trim();\n  if (!trimmed) return null;\n  const normalized = path.resolve(trimmed);\n  const nodeModulesDir = path.dirname(normalized);\n  if (path.basename(nodeModulesDir) !== 'node_modules') return null;\n  const parentDir = path.dirname(nodeModulesDir);\n  if (path.basename(parentDir) === 'lib') {\n    return path.dirname(parentDir);\n  }\n  if (process.platform === 'win32' && path.basename(parentDir).toLowerCase() === 'npm') {\n    return parentDir;\n  }\n  return null;\n}\n\nfunction resolvePreferredNpmCommand(pkgRoot?: string | null): string | null {\n  const prefix = inferNpmPrefixFromPackageRoot(pkgRoot);\n  if (!prefix) return null;\n  const candidate =\n    process.platform === 'win32' ? path.join(prefix, 'npm.cmd') : path.join(prefix, 'bin', 'npm');\n  return fsSync.existsSync(candidate) ? candidate : null;\n}\n\nfunction resolveNpmFromExecPath(): string | null {\n  const execPath = process.execPath?.trim();\n  if (!execPath) return null;\n  const binDir = path.dirname(execPath);\n  const candidate =\n    process.platform === 'win32' ? path.join(binDir, 'npm.cmd') : path.join(binDir, 'npm');\n  return fsSync.existsSync(candidate) ? candidate : null;\n}\n\nfunction resolvePreferredGlobalManagerCommand(\n  manager: GlobalInstallManager,\n  pkgRoot?: string | null,\n): string {\n  if (manager !== 'npm') return manager;\n  return resolvePreferredNpmCommand(pkgRoot) ?? resolveNpmFromExecPath() ?? manager;\n}\n\nexport function resolveGlobalInstallCommand(\n  manager: GlobalInstallManager,\n  pkgRoot?: string | null,\n): ResolvedGlobalInstallCommand {\n  return {\n    manager,\n    command: resolvePreferredGlobalManagerCommand(manager, pkgRoot),\n  };\n}\n\nfunction normalizeGlobalInstallCommand(\n  managerOrCommand: GlobalInstallManager | ResolvedGlobalInstallCommand,\n  pkgRoot?: string | null,\n): ResolvedGlobalInstallCommand {\n  return typeof managerOrCommand === 'string'\n    ? resolveGlobalInstallCommand(managerOrCommand, pkgRoot)\n    : managerOrCommand;\n}\n\nexport function resolveNpmGlobalPrefixLayoutFromGlobalRoot(\n  globalRoot?: string | null,\n): NpmGlobalPrefixLayout | null {\n  const trimmed = globalRoot?.trim();\n  if (!trimmed) return null;\n  const normalized = path.resolve(trimmed);\n  if (path.basename(normalized) !== 'node_modules') return null;\n  const parentDir = path.dirname(normalized);\n  if (path.basename(parentDir) === 'lib') {\n    const prefix = path.dirname(parentDir);\n    return {\n      prefix,\n      globalRoot: normalized,\n      binDir: path.join(prefix, 'bin'),\n    };\n  }\n  if (process.platform === 'win32') {\n    return {\n      prefix: parentDir,\n      globalRoot: normalized,\n      binDir: parentDir,\n    };\n  }\n  return null;\n}\n\nexport function resolveNpmGlobalPrefixLayoutFromPrefix(prefix: string): NpmGlobalPrefixLayout {\n  const resolvedPrefix = path.resolve(prefix);\n  if (process.platform === 'win32') {\n    return {\n      prefix: resolvedPrefix,\n      globalRoot: path.join(resolvedPrefix, 'node_modules'),\n      binDir: resolvedPrefix,\n    };\n  }\n  return {\n    prefix: resolvedPrefix,\n    globalRoot: path.join(resolvedPrefix, 'lib', 'node_modules'),\n    binDir: path.join(resolvedPrefix, 'bin'),\n  };\n}\n\nfunction applyWindowsPackageInstallEnv(env: Record<string, string>): void {\n  if (process.platform !== 'win32') return;\n  env.NPM_CONFIG_UPDATE_NOTIFIER = 'false';\n  env.NPM_CONFIG_FUND = 'false';\n  env.NPM_CONFIG_AUDIT = 'false';\n}\n\nfunction applyCorepackDownloadPromptEnv(env: Record<string, string>): void {\n  if (!env.COREPACK_ENABLE_DOWNLOAD_PROMPT?.trim()) {\n    env.COREPACK_ENABLE_DOWNLOAD_PROMPT = COREPACK_ENABLE_DOWNLOAD_PROMPT_DEFAULT;\n  }\n}\n\nexport async function createGlobalInstallEnv(\n  env?: NodeJS.ProcessEnv,\n): Promise<NodeJS.ProcessEnv | undefined> {\n  const pathPrepend = resolveExecPathBinPrepend();\n  const sourceEnv = env ?? process.env;\n  const hasCorepack = Boolean(sourceEnv.COREPACK_ENABLE_DOWNLOAD_PROMPT?.trim());\n  if (process.platform !== 'win32' && hasCorepack && pathPrepend.length === 0) {\n    return env;\n  }\n  const merged = Object.fromEntries(\n    Object.entries(sourceEnv)\n      .filter(([, value]) => value != null)\n      .map(([key, value]) => [key, String(value)]),\n  ) as Record<string, string>;\n  applyPathPrepend(merged, pathPrepend);\n  applyWindowsPackageInstallEnv(merged);\n  applyCorepackDownloadPromptEnv(merged);\n  return merged;\n}\n\nexport function resolveGlobalInstallSpec(params: {\n  version: string;\n  env?: NodeJS.ProcessEnv;\n}): string {\n  const override =\n    params.env?.XOPC_UPDATE_PACKAGE_SPEC?.trim() || process.env.XOPC_UPDATE_PACKAGE_SPEC?.trim();\n  if (override) return override;\n  return `${XOPC_PACKAGE_NAME}@${params.version}`;\n}\n\nexport function resolveExpectedInstalledVersionFromSpec(spec: string): string | null {\n  const normalized = spec.trim();\n  if (!normalized.startsWith(`${XOPC_PACKAGE_NAME}@`)) return null;\n  const rawVersion = normalized.slice(XOPC_PACKAGE_NAME.length + 1).trim();\n  if (\n    !rawVersion ||\n    rawVersion.includes('/') ||\n    rawVersion.includes(':') ||\n    rawVersion.includes('#') ||\n    /^(latest|beta|next|dev)$/i.test(rawVersion)\n  ) {\n    return null;\n  }\n  return rawVersion;\n}\n\nexport async function collectInstalledGlobalPackageErrors(params: {\n  packageRoot: string;\n  expectedVersion?: string | null;\n}): Promise<string[]> {\n  const errors: string[] = [];\n  const installedVersion = await readPackageVersion(params.packageRoot);\n  if (params.expectedVersion && installedVersion !== params.expectedVersion) {\n    errors.push(\n      `expected installed version ${params.expectedVersion}, found ${installedVersion ?? '<missing>'}`,\n    );\n  }\n  if (!installedVersion) {\n    errors.push('missing package.json version');\n  }\n  return errors;\n}\n\nexport async function resolveGlobalRoot(\n  managerOrCommand: GlobalInstallManager | ResolvedGlobalInstallCommand,\n  runCommand: CommandRunner,\n  timeoutMs: number,\n  pkgRoot?: string | null,\n): Promise<string | null> {\n  const resolved = normalizeGlobalInstallCommand(managerOrCommand, pkgRoot);\n  const argv = [resolved.command, 'root', '-g'];\n  const res = await runCommand(argv, { timeoutMs }).catch(() => null);\n  if (!res || res.code !== 0) return null;\n  const root = res.stdout.trim();\n  return root || null;\n}\n\nexport async function resolveGlobalPackageRoot(\n  managerOrCommand: GlobalInstallManager | ResolvedGlobalInstallCommand,\n  runCommand: CommandRunner,\n  timeoutMs: number,\n  pkgRoot?: string | null,\n): Promise<string | null> {\n  const root = await resolveGlobalRoot(managerOrCommand, runCommand, timeoutMs, pkgRoot);\n  if (!root) return null;\n  return joinGlobalPackagePath(root);\n}\n\nexport async function resolveGlobalInstallTarget(params: {\n  manager: GlobalInstallManager | ResolvedGlobalInstallCommand;\n  runCommand: CommandRunner;\n  timeoutMs: number;\n  pkgRoot?: string | null;\n}): Promise<ResolvedGlobalInstallTarget> {\n  const command = normalizeGlobalInstallCommand(params.manager, params.pkgRoot);\n  const globalRoot = await resolveGlobalRoot(\n    command,\n    params.runCommand,\n    params.timeoutMs,\n    params.pkgRoot,\n  );\n  return {\n    ...command,\n    globalRoot,\n    packageRoot: globalRoot ? joinGlobalPackagePath(globalRoot) : null,\n  };\n}\n\nexport function globalInstallArgs(\n  managerOrCommand: GlobalInstallManager | ResolvedGlobalInstallCommand,\n  spec: string,\n  pkgRoot?: string | null,\n  installPrefix?: string | null,\n): string[] {\n  const resolved = normalizeGlobalInstallCommand(managerOrCommand, pkgRoot);\n  if (resolved.manager === 'pnpm') {\n    return [resolved.command, 'add', '-g', spec];\n  }\n  return [\n    resolved.command,\n    'install',\n    '-g',\n    ...(installPrefix ? ['--prefix', installPrefix] : []),\n    spec,\n    ...NPM_GLOBAL_INSTALL_QUIET_FLAGS,\n  ];\n}\n\nexport function globalInstallFallbackArgs(\n  managerOrCommand: GlobalInstallManager | ResolvedGlobalInstallCommand,\n  spec: string,\n  pkgRoot?: string | null,\n  installPrefix?: string | null,\n): string[] | null {\n  const resolved = normalizeGlobalInstallCommand(managerOrCommand, pkgRoot);\n  if (resolved.manager !== 'npm') return null;\n  return [\n    resolved.command,\n    'install',\n    '-g',\n    ...(installPrefix ? ['--prefix', installPrefix] : []),\n    spec,\n    ...NPM_GLOBAL_INSTALL_OMIT_OPTIONAL_FLAGS,\n  ];\n}\n\nexport async function cleanupGlobalRenameDirs(params: {\n  globalRoot: string;\n  packageName: string;\n}): Promise<{ removed: string[] }> {\n  const removed: string[] = [];\n  const root = params.globalRoot.trim();\n  const name = params.packageName.trim();\n  if (!root || !name) return { removed };\n  const prefix = `${GLOBAL_RENAME_PREFIX}${name}-`;\n  let entries: string[] = [];\n  try {\n    entries = await fs.readdir(root);\n  } catch {\n    return { removed };\n  }\n  for (const entry of entries) {\n    if (!entry.startsWith(prefix)) continue;\n    const target = path.join(root, entry);\n    try {\n      const stat = await fs.lstat(target);\n      if (!stat.isDirectory()) continue;\n      await fs.rm(target, { recursive: true, force: true });\n      removed.push(entry);\n    } catch {\n      // ignore\n    }\n  }\n  return { removed };\n}\n\nexport async function detectGlobalInstallManagerForRoot(\n  runCommand: CommandRunner,\n  pkgRoot: string,\n  timeoutMs: number,\n): Promise<GlobalInstallManager | null> {\n  const pkgReal = await tryRealpath(pkgRoot);\n  const npmCommand = resolvePreferredGlobalManagerCommand('npm', pkgRoot);\n  const candidates: Array<{ manager: GlobalInstallManager; argv: string[] }> = [\n    { manager: 'npm', argv: [npmCommand, 'root', '-g'] },\n    { manager: 'pnpm', argv: ['pnpm', 'root', '-g'] },\n  ];\n\n  for (const { manager, argv } of candidates) {\n    const res = await runCommand(argv, { timeoutMs }).catch(() => null);\n    if (!res || res.code !== 0) continue;\n    const globalRoot = res.stdout.trim();\n    if (!globalRoot) continue;\n    const globalReal = await tryRealpath(globalRoot);\n    const expected = joinGlobalPackagePath(globalReal);\n    const expectedReal = await tryRealpath(expected);\n    if (path.resolve(expectedReal) === path.resolve(pkgReal)) {\n      return manager;\n    }\n  }\n\n  if (resolvePreferredNpmCommand(pkgRoot) || resolveNpmFromExecPath()) {\n    return 'npm';\n  }\n\n  return null;\n}\n\nexport async function detectGlobalInstallManagerByPresence(\n  runCommand: CommandRunner,\n  timeoutMs: number,\n): Promise<GlobalInstallManager | null> {\n  for (const manager of ['npm', 'pnpm'] as const) {\n    const root = await resolveGlobalRoot(manager, runCommand, timeoutMs);\n    if (!root) continue;\n    if (await pathExists(joinGlobalPackagePath(root))) {\n      return manager;\n    }\n  }\n  return null;\n}\n\nexport async function resolveGlobalManager(params: {\n  root: string | null;\n  timeoutMs?: number;\n}): Promise<GlobalInstallManager> {\n  const runCommand = createDefaultCommandRunner();\n  const timeoutMs = params.timeoutMs ?? GLOBAL_DETECT_TIMEOUT_MS;\n\n  if (params.root) {\n    const detected = await detectGlobalInstallManagerForRoot(runCommand, params.root, timeoutMs);\n    if (detected) return detected;\n  }\n\n  const byPresence = await detectGlobalInstallManagerByPresence(runCommand, timeoutMs);\n  return byPresence ?? 'npm';\n}\n"],"mappings":"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"}

package/dist/src/infra/update-log.d.ts

@@ -0,0 +1 @@
+export declare function trimLogTail(text: string | null | undefined, maxChars: number): string | null;

package/dist/src/infra/update-log.js

@@ -0,0 +1,12 @@
+//#region src/infra/update-log.ts
+function trimLogTail(text, maxChars) {
+	if (!text) return null;
+	const trimmed = text.trim();
+	if (!trimmed) return null;
+	if (trimmed.length <= maxChars) return trimmed;
+	return trimmed.slice(-maxChars);
+}
+//#endregion
+export { trimLogTail };
+
+//# sourceMappingURL=update-log.js.map

package/dist/src/infra/update-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-log.js","names":[],"sources":["../../../src/infra/update-log.ts"],"sourcesContent":["export function trimLogTail(text: string | null | undefined, maxChars: number): string | null {\n  if (!text) return null;\n  const trimmed = text.trim();\n  if (!trimmed) return null;\n  if (trimmed.length <= maxChars) return trimmed;\n  return trimmed.slice(-maxChars);\n}\n"],"mappings":";AAAA,SAAgB,YAAY,MAAiC,UAAiC;AAC5F,KAAI,CAAC,KAAM,QAAO;CAClB,MAAM,UAAU,KAAK,MAAM;AAC3B,KAAI,CAAC,QAAS,QAAO;AACrB,KAAI,QAAQ,UAAU,SAAU,QAAO;AACvC,QAAO,QAAQ,MAAM,CAAC,SAAS"}

package/dist/src/infra/update-restart.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Gateway restart after xopc update — daemon, unmanaged, or in-process respawn.
+ */
+export type UpdateRestartResult = {
+    ok: boolean;
+    mode: 'in-process' | 'daemon' | 'unmanaged' | 'skipped' | 'disabled' | 'failed';
+    message?: string;
+};
+export type InProcessRestartTrigger = () => {
+    ok: boolean;
+    mode?: string;
+    message?: string;
+};
+export declare function isRunningInsideGatewayService(env?: Record<string, string | undefined>): boolean;
+export declare function maybeRestartGatewayAfterUpdate(params: {
+    shouldRestart?: boolean;
+    expectedVersion?: string;
+    configPath?: string;
+    triggerInProcessRestart?: InProcessRestartTrigger;
+}): Promise<UpdateRestartResult>;

package/dist/src/infra/update-restart.js

@@ -0,0 +1,165 @@
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
+import { init_paths, resolveConfigPath } from "../config/paths.js";
+import { init_loader, loadConfig } from "../config/loader.js";
+import { isRestartEnabled } from "../config/commands.flags.js";
+import { resolveGatewayService } from "../daemon/service.js";
+import { authorizeGatewaySigusr1Restart, writeGatewayRestartIntentSync } from "./restart.js";
+import { findVerifiedGatewayListenerPidsOnPortSync, signalVerifiedGatewayPidSync } from "./gateway-processes.js";
+//#region src/infra/update-restart.ts
+init_loader();
+init_paths();
+init_logger();
+const log = createLogger("UpdateRestart");
+const DEFAULT_HEALTH_ATTEMPTS = 120;
+const DEFAULT_HEALTH_DELAY_MS = 500;
+function isRunningInsideGatewayService(env = process.env) {
+	return env.XOPC_SERVICE_MARKER?.trim() === "1";
+}
+function resolveGatewayPort(configPath) {
+	const config = loadConfig(configPath ?? resolveConfigPath());
+	return typeof config.gateway?.port === "number" ? config.gateway.port : 18790;
+}
+function parsePortFromArgs(programArguments) {
+	if (!programArguments?.length) return null;
+	for (let i = 0; i < programArguments.length; i += 1) {
+		const arg = programArguments[i];
+		if (arg === "--port") {
+			const parsed = parseInt(String(programArguments[i + 1]), 10);
+			if (Number.isFinite(parsed) && parsed > 0) return parsed;
+		}
+		if (arg?.startsWith("--port=")) {
+			const parsed = parseInt(arg.split("=", 2)[1] ?? "", 10);
+			if (Number.isFinite(parsed) && parsed > 0) return parsed;
+		}
+	}
+	return null;
+}
+async function resolveRestartPort(service) {
+	return parsePortFromArgs((await service.readCommand(process.env).catch(() => null))?.programArguments) ?? resolveGatewayPort();
+}
+async function waitForGatewayHealth(port, expectedVersion) {
+	for (let attempt = 0; attempt < DEFAULT_HEALTH_ATTEMPTS; attempt += 1) try {
+		const controller = new AbortController();
+		const timeout = setTimeout(() => controller.abort(), 1500);
+		const response = await fetch(`http://127.0.0.1:${port}/api/health`, {
+			method: "GET",
+			signal: controller.signal
+		});
+		clearTimeout(timeout);
+		if (!response.ok) {
+			await new Promise((r) => setTimeout(r, DEFAULT_HEALTH_DELAY_MS));
+			continue;
+		}
+		if (expectedVersion) {
+			const body = await response.json();
+			if (body.version && body.version !== expectedVersion) {
+				await new Promise((r) => setTimeout(r, DEFAULT_HEALTH_DELAY_MS));
+				continue;
+			}
+		}
+		return true;
+	} catch {
+		await new Promise((r) => setTimeout(r, DEFAULT_HEALTH_DELAY_MS));
+	}
+	return false;
+}
+async function restartUnmanagedGateway(port, configPath) {
+	if (!isRestartEnabled(loadConfig(configPath ?? resolveConfigPath()))) return {
+		ok: false,
+		mode: "disabled",
+		message: "Gateway restart is disabled in config (commands.restart=false). Restart manually: xopc gateway restart"
+	};
+	const pids = findVerifiedGatewayListenerPidsOnPortSync(port).filter((pid) => Number.isFinite(pid) && pid > 0);
+	if (pids.length === 0) return {
+		ok: false,
+		mode: "failed",
+		message: `No gateway listener found on port ${port}.`
+	};
+	if (pids.length > 1) return {
+		ok: false,
+		mode: "failed",
+		message: `Multiple gateway processes on port ${port}; use "xopc gateway status" before retrying.`
+	};
+	const targetPid = pids[0];
+	if (process.platform === "win32") {
+		writeGatewayRestartIntentSync({ targetPid });
+		signalVerifiedGatewayPidSync(targetPid, "SIGTERM");
+	} else {
+		authorizeGatewaySigusr1Restart();
+		signalVerifiedGatewayPidSync(targetPid, "SIGUSR1");
+	}
+	return {
+		ok: true,
+		mode: "unmanaged",
+		message: `Gateway restart signal sent to process ${targetPid} on port ${port}.`
+	};
+}
+async function restartDaemonGateway(service, port, expectedVersion) {
+	try {
+		if (!await service.isLoaded({ env: process.env })) return restartUnmanagedGateway(port);
+		await service.restart({
+			env: process.env,
+			stdout: process.stdout
+		});
+		if (!await waitForGatewayHealth(port, expectedVersion)) {
+			log.warn({
+				port,
+				expectedVersion
+			}, "Gateway restart completed but health check timed out");
+			return {
+				ok: true,
+				mode: "daemon",
+				message: "Gateway service restarted; health check timed out (gateway may still be starting)."
+			};
+		}
+		return {
+			ok: true,
+			mode: "daemon",
+			message: "Gateway service restarted successfully."
+		};
+	} catch (err) {
+		const message = err instanceof Error ? err.message : String(err);
+		log.warn({
+			err,
+			port
+		}, `Daemon restart failed: ${message}`);
+		return {
+			ok: false,
+			mode: "failed",
+			message
+		};
+	}
+}
+async function maybeRestartGatewayAfterUpdate(params) {
+	if (params.shouldRestart === false) return {
+		ok: true,
+		mode: "skipped",
+		message: "Restart skipped (--no-restart)."
+	};
+	if (!isRestartEnabled(loadConfig(params.configPath ?? resolveConfigPath()))) return {
+		ok: false,
+		mode: "disabled",
+		message: "Gateway restart is disabled (commands.restart=false). Restart manually: xopc gateway restart"
+	};
+	if (isRunningInsideGatewayService() && params.triggerInProcessRestart) {
+		const result = params.triggerInProcessRestart();
+		if (!result.ok) return {
+			ok: false,
+			mode: "failed",
+			message: result.message ?? "In-process gateway restart failed."
+		};
+		log.info({ mode: result.mode }, "Scheduled in-process gateway restart after update");
+		return {
+			ok: true,
+			mode: "in-process",
+			message: result.message ?? "Gateway restart scheduled."
+		};
+	}
+	const service = await resolveGatewayService();
+	return restartDaemonGateway(service, await resolveRestartPort(service), params.expectedVersion);
+}
+//#endregion
+export { isRunningInsideGatewayService, maybeRestartGatewayAfterUpdate };
+
+//# sourceMappingURL=update-restart.js.map

package/dist/src/infra/update-restart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-restart.js","names":[],"sources":["../../../src/infra/update-restart.ts"],"sourcesContent":["/**\n * Gateway restart after xopc update — daemon, unmanaged, or in-process respawn.\n */\n\nimport { loadConfig } from '../config/loader.js';\nimport { resolveConfigPath } from '../config/paths.js';\nimport { isRestartEnabled } from '../config/commands.flags.js';\nimport { resolveGatewayService } from '../daemon/service.js';\nimport type { GatewayService } from '../daemon/types.js';\nimport {\n  findVerifiedGatewayListenerPidsOnPortSync,\n  signalVerifiedGatewayPidSync,\n} from './gateway-processes.js';\nimport { authorizeGatewaySigusr1Restart, writeGatewayRestartIntentSync } from './restart.js';\nimport { createLogger } from '../utils/logger.js';\n\nconst log = createLogger('UpdateRestart');\n\nconst DEFAULT_HEALTH_ATTEMPTS = 120;\nconst DEFAULT_HEALTH_DELAY_MS = 500;\n\nexport type UpdateRestartResult = {\n  ok: boolean;\n  mode: 'in-process' | 'daemon' | 'unmanaged' | 'skipped' | 'disabled' | 'failed';\n  message?: string;\n};\n\nexport type InProcessRestartTrigger = () => { ok: boolean; mode?: string; message?: string };\n\nexport function isRunningInsideGatewayService(\n  env: Record<string, string | undefined> = process.env,\n): boolean {\n  return env.XOPC_SERVICE_MARKER?.trim() === '1';\n}\n\nfunction resolveGatewayPort(configPath?: string): number {\n  const config = loadConfig(configPath ?? resolveConfigPath());\n  return typeof config.gateway?.port === 'number' ? config.gateway.port : 18790;\n}\n\nfunction parsePortFromArgs(programArguments: string[] | undefined): number | null {\n  if (!programArguments?.length) {\n    return null;\n  }\n  for (let i = 0; i < programArguments.length; i += 1) {\n    const arg = programArguments[i];\n    if (arg === '--port') {\n      const parsed = parseInt(String(programArguments[i + 1]), 10);\n      if (Number.isFinite(parsed) && parsed > 0) {\n        return parsed;\n      }\n    }\n    if (arg?.startsWith('--port=')) {\n      const parsed = parseInt(arg.split('=', 2)[1] ?? '', 10);\n      if (Number.isFinite(parsed) && parsed > 0) {\n        return parsed;\n      }\n    }\n  }\n  return null;\n}\n\nasync function resolveRestartPort(service: GatewayService): Promise<number> {\n  const command = await service.readCommand(process.env).catch(() => null);\n  return parsePortFromArgs(command?.programArguments) ?? resolveGatewayPort();\n}\n\nasync function waitForGatewayHealth(port: number, expectedVersion?: string): Promise<boolean> {\n  for (let attempt = 0; attempt < DEFAULT_HEALTH_ATTEMPTS; attempt += 1) {\n    try {\n      const controller = new AbortController();\n      const timeout = setTimeout(() => controller.abort(), 1500);\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        await new Promise((r) => setTimeout(r, DEFAULT_HEALTH_DELAY_MS));\n        continue;\n      }\n      if (expectedVersion) {\n        const body = (await response.json()) as { version?: string };\n        if (body.version && body.version !== expectedVersion) {\n          await new Promise((r) => setTimeout(r, DEFAULT_HEALTH_DELAY_MS));\n          continue;\n        }\n      }\n      return true;\n    } catch {\n      await new Promise((r) => setTimeout(r, DEFAULT_HEALTH_DELAY_MS));\n    }\n  }\n  return false;\n}\n\nasync function restartUnmanagedGateway(port: number, configPath?: string): Promise<UpdateRestartResult> {\n  const config = loadConfig(configPath ?? resolveConfigPath());\n  if (!isRestartEnabled(config)) {\n    return {\n      ok: false,\n      mode: 'disabled',\n      message:\n        'Gateway restart is disabled in config (commands.restart=false). Restart manually: xopc gateway restart',\n    };\n  }\n\n  const pids = findVerifiedGatewayListenerPidsOnPortSync(port).filter(\n    (pid): pid is number => Number.isFinite(pid) && pid > 0,\n  );\n  if (pids.length === 0) {\n    return {\n      ok: false,\n      mode: 'failed',\n      message: `No gateway listener found on port ${port}.`,\n    };\n  }\n  if (pids.length > 1) {\n    return {\n      ok: false,\n      mode: 'failed',\n      message: `Multiple gateway processes on port ${port}; use \"xopc gateway status\" before retrying.`,\n    };\n  }\n\n  const targetPid = pids[0];\n  if (process.platform === 'win32') {\n    writeGatewayRestartIntentSync({ targetPid });\n    signalVerifiedGatewayPidSync(targetPid, 'SIGTERM');\n  } else {\n    authorizeGatewaySigusr1Restart();\n    signalVerifiedGatewayPidSync(targetPid, 'SIGUSR1');\n  }\n\n  return {\n    ok: true,\n    mode: 'unmanaged',\n    message: `Gateway restart signal sent to process ${targetPid} on port ${port}.`,\n  };\n}\n\nasync function restartDaemonGateway(\n  service: GatewayService,\n  port: number,\n  expectedVersion?: string,\n): Promise<UpdateRestartResult> {\n  try {\n    const loaded = await service.isLoaded({ env: process.env });\n    if (!loaded) {\n      return restartUnmanagedGateway(port);\n    }\n    await service.restart({ env: process.env, stdout: process.stdout });\n    const healthy = await waitForGatewayHealth(port, expectedVersion);\n    if (!healthy) {\n      log.warn({ port, expectedVersion }, 'Gateway restart completed but health check timed out');\n      return {\n        ok: true,\n        mode: 'daemon',\n        message: 'Gateway service restarted; health check timed out (gateway may still be starting).',\n      };\n    }\n    return {\n      ok: true,\n      mode: 'daemon',\n      message: 'Gateway service restarted successfully.',\n    };\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    log.warn({ err, port }, `Daemon restart failed: ${message}`);\n    return { ok: false, mode: 'failed', message };\n  }\n}\n\nexport async function maybeRestartGatewayAfterUpdate(params: {\n  shouldRestart?: boolean;\n  expectedVersion?: string;\n  configPath?: string;\n  triggerInProcessRestart?: InProcessRestartTrigger;\n}): Promise<UpdateRestartResult> {\n  if (params.shouldRestart === false) {\n    return { ok: true, mode: 'skipped', message: 'Restart skipped (--no-restart).' };\n  }\n\n  const config = loadConfig(params.configPath ?? resolveConfigPath());\n  if (!isRestartEnabled(config)) {\n    return {\n      ok: false,\n      mode: 'disabled',\n      message:\n        'Gateway restart is disabled (commands.restart=false). Restart manually: xopc gateway restart',\n    };\n  }\n\n  if (isRunningInsideGatewayService() && params.triggerInProcessRestart) {\n    const result = params.triggerInProcessRestart();\n    if (!result.ok) {\n      return {\n        ok: false,\n        mode: 'failed',\n        message: result.message ?? 'In-process gateway restart failed.',\n      };\n    }\n    log.info({ mode: result.mode }, 'Scheduled in-process gateway restart after update');\n    return {\n      ok: true,\n      mode: 'in-process',\n      message: result.message ?? 'Gateway restart scheduled.',\n    };\n  }\n\n  const service = await resolveGatewayService();\n  const port = await resolveRestartPort(service);\n  return restartDaemonGateway(service, port, params.expectedVersion);\n}\n"],"mappings":"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"}