@pixelzx/genesis 2026.6.28 → 2026.7.8

package/dist/update-cli-D8bMov5W.js

@@ -1,1759 +0,0 @@
-import { a as normalizeLowercaseStringOrEmpty, c as normalizeOptionalString } from "./string-coerce-DPP_aYVc.js";
-import { t as resolveGenesisPackageRoot } from "./genesis-root-BREm_erB.js";
-import { d as pathExists } from "./utils-CWrkFsp0.js";
-import { n as defaultRuntime } from "./runtime-DDkDH9fa.js";
-import { t as formatDocsLink } from "./links-C1-jbHJx.js";
-import { r as theme } from "./theme-DD6pQv2_.js";
-import { n as inheritOptionFromParent } from "./command-options-BAeBeFgJ.js";
-import "./daemon-cli-BXtGpvAS.js";
-import { n as resolveCliName, t as replaceCliName } from "./cli-name-Dx-I_gso.js";
-import { t as formatCliCommand } from "./command-format-B3Q5KD9o.js";
-import { n as DEFAULT_GATEWAY_PORT, u as resolveGatewayPort } from "./paths-Bv2rGpO9.js";
-import { f as resolveGatewaySystemdServiceName, l as resolveGatewayLaunchAgentLabel, p as resolveGatewayWindowsTaskName } from "./constants-a99_SBoO.js";
-import { o as resolveGatewayInstallEntrypoint } from "./daemon-install-plan.shared-sDw4anZ6.js";
-import { a as parseSemver, i as nodeVersionSatisfiesEngine } from "./runtime-guard-B2AXF2AU.js";
-import { r as runCommandWithTimeout } from "./exec-BbrLAvgI.js";
-import { L as asResolvedSourceConfig, R as asRuntimeConfig, u as readConfigFileSnapshot } from "./io-Cy5vajWd.js";
-import { a as shellEscapeRestartLogValue, i as resolveGatewayRestartLogPath, n as renderPosixRestartLogSetup, s as quoteCmdScriptArg, t as renderCmdRestartLogSetup } from "./restart-logs-B0OTqRo0.js";
-import { r as resolveGatewayService } from "./service-DiHWY6iI.js";
-import { t as runDaemonInstall } from "./install-C_Y23kyx.js";
-import { r as replaceConfigFile } from "./mutate-D3NIW5dU.js";
-import "./config-DYHZ3jG1.js";
-import { t as runDaemonRestart } from "./lifecycle-BRey6jez.js";
-import { n as formatConfigIssueLines } from "./issue-format-BlLjCfYX.js";
-import { l as waitForGatewayHealthyRestart, o as renderRestartDiagnostics, s as terminateStaleGatewayPids } from "./restart-health-CSxm-1Te.js";
-import { u as trimLogTail } from "./restart-sentinel-YnIhjSi0.js";
-import { r as formatDurationPrecise } from "./format-duration-D7ua_Cv_.js";
-import { n as stylePromptMessage } from "./prompt-style-CSYFxrBs.js";
-import { t as formatHelpExamples } from "./help-format-XI0mCjwz.js";
-import { r as installCompletion } from "./completion-runtime-BOk6rDti.js";
-import { n as renderTable, t as getTerminalTableWidth } from "./table-DGHkdVw4.js";
-import { n as updateNpmInstalledPlugins, t as syncPluginsForUpdateChannel } from "./update-D8foEnSw.js";
-import { n as doctorCommand, t as selectStyled } from "./prompt-select-styled-DFXPq9zJ.js";
-import { d as formatUpdateChannelLabel, g as resolveUpdateChannelDisplay, h as resolveEffectiveUpdateChannel, i as fetchNpmTagVersion, m as normalizeUpdateChannel, n as compareSemverStrings, o as resolveNpmChannelTag, r as fetchNpmPackageTargetStatus, t as checkUpdateStatus, u as channelToNpmTag } from "./update-check-Dpeu-94s.js";
-import { i as resolveUpdateAvailability, n as formatUpdateOneLiner, t as formatUpdateAvailableHint } from "./status.update-BuQ1BmeP.js";
-import { a as createGlobalInstallEnv, c as globalInstallArgs, d as resolveGlobalInstallSpec, f as resolveGlobalInstallTarget, h as readPackageVersion, i as collectInstalledGlobalPackageErrors, l as globalInstallFallbackArgs, m as readPackageName, n as canResolveRegistryVersionForPackageTarget, o as detectGlobalInstallManagerByPresence, p as normalizePackageTagInput, r as cleanupGlobalRenameDirs, s as detectGlobalInstallManagerForRoot, t as runGatewayUpdate, u as resolveExpectedInstalledVersionFromSpec } from "./update-runner-UZcPawrd.js";
-import { r as ensureCompletionCacheExists, t as checkShellCompletionStatus } from "./doctor-completion-h1srb2tT.js";
-import path from "node:path";
-import { spawn, spawnSync } from "node:child_process";
-import os from "node:os";
-import fs from "node:fs/promises";
-import { confirm, isCancel, spinner } from "@clack/prompts";
-//#region src/cli/update-cli/shared.ts
-const INVALID_TIMEOUT_ERROR = "--timeout must be a positive integer (seconds)";
-function parseTimeoutMsOrExit(timeout) {
-	const timeoutMs = timeout ? Number.parseInt(timeout, 10) * 1e3 : void 0;
-	if (timeoutMs !== void 0 && (Number.isNaN(timeoutMs) || timeoutMs <= 0)) {
-		defaultRuntime.error(INVALID_TIMEOUT_ERROR);
-		defaultRuntime.exit(1);
-		return null;
-	}
-	return timeoutMs;
-}
-const GENESIS_REPO_URL = "https://github.com/PIXELZX0/Genesis.git";
-const MAX_LOG_CHARS = 8e3;
-const DEFAULT_PACKAGE_NAME = "@pixelzx/genesis";
-const LEGACY_PACKAGE_NAME = "genesis";
-const CORE_PACKAGE_NAMES = new Set([DEFAULT_PACKAGE_NAME, LEGACY_PACKAGE_NAME]);
-function normalizeTag(value) {
-	return normalizePackageTagInput(value, [DEFAULT_PACKAGE_NAME, LEGACY_PACKAGE_NAME]);
-}
-function normalizeVersionTag(tag) {
-	const trimmed = tag.trim();
-	if (!trimmed) return null;
-	const cleaned = trimmed.startsWith("v") ? trimmed.slice(1) : trimmed;
-	return parseSemver(cleaned) ? cleaned : null;
-}
-async function resolveTargetVersion(tag, timeoutMs, packageName = DEFAULT_PACKAGE_NAME) {
-	if (!canResolveRegistryVersionForPackageTarget(tag)) return null;
-	const direct = normalizeVersionTag(tag);
-	if (direct) return direct;
-	return (await fetchNpmTagVersion({
-		packageName,
-		tag,
-		timeoutMs
-	})).version ?? null;
-}
-async function isGitCheckout(root) {
-	try {
-		await fs.stat(path.join(root, ".git"));
-		return true;
-	} catch {
-		return false;
-	}
-}
-async function isCorePackage(root) {
-	const name = await readPackageName(root);
-	return Boolean(name && CORE_PACKAGE_NAMES.has(name));
-}
-async function isEmptyDir(targetPath) {
-	try {
-		return (await fs.readdir(targetPath)).length === 0;
-	} catch {
-		return false;
-	}
-}
-function resolveGitInstallDir() {
-	const override = process.env.GENESIS_GIT_DIR?.trim();
-	if (override) return path.resolve(override);
-	return resolveDefaultGitDir();
-}
-function resolveDefaultGitDir() {
-	const home = os.homedir();
-	if (home.startsWith("/")) return path.posix.join(home, "genesis");
-	return path.join(home, "genesis");
-}
-function resolveNodeRunner() {
-	const base = normalizeLowercaseStringOrEmpty(path.basename(process.execPath));
-	if (base === "node" || base === "node.exe") return process.execPath;
-	return "node";
-}
-async function resolveUpdateRoot() {
-	return await resolveGenesisPackageRoot({
-		moduleUrl: import.meta.url,
-		argv1: process.argv[1],
-		cwd: process.cwd()
-	}) ?? process.cwd();
-}
-async function runUpdateStep(params) {
-	const command = params.argv.join(" ");
-	params.progress?.onStepStart?.({
-		name: params.name,
-		command,
-		index: 0,
-		total: 0
-	});
-	const started = Date.now();
-	const res = await runCommandWithTimeout(params.argv, {
-		cwd: params.cwd,
-		env: params.env,
-		timeoutMs: params.timeoutMs
-	});
-	const durationMs = Date.now() - started;
-	const stderrTail = trimLogTail(res.stderr, MAX_LOG_CHARS);
-	params.progress?.onStepComplete?.({
-		name: params.name,
-		command,
-		index: 0,
-		total: 0,
-		durationMs,
-		exitCode: res.code,
-		stderrTail
-	});
-	return {
-		name: params.name,
-		command,
-		cwd: params.cwd ?? process.cwd(),
-		durationMs,
-		exitCode: res.code,
-		stdoutTail: trimLogTail(res.stdout, MAX_LOG_CHARS),
-		stderrTail
-	};
-}
-async function ensureGitCheckout(params) {
-	const gitEnv = params.env ?? await createGlobalInstallEnv();
-	if (!await pathExists(params.dir)) return await runUpdateStep({
-		name: "git clone",
-		argv: [
-			"git",
-			"clone",
-			GENESIS_REPO_URL,
-			params.dir
-		],
-		env: gitEnv,
-		timeoutMs: params.timeoutMs,
-		progress: params.progress
-	});
-	if (!await isGitCheckout(params.dir)) {
-		if (!await isEmptyDir(params.dir)) throw new Error(`GENESIS_GIT_DIR points at a non-git directory: ${params.dir}. Set GENESIS_GIT_DIR to an empty folder or an genesis checkout.`);
-		return await runUpdateStep({
-			name: "git clone",
-			argv: [
-				"git",
-				"clone",
-				GENESIS_REPO_URL,
-				params.dir
-			],
-			cwd: params.dir,
-			env: gitEnv,
-			timeoutMs: params.timeoutMs,
-			progress: params.progress
-		});
-	}
-	if (!await isCorePackage(params.dir)) throw new Error(`GENESIS_GIT_DIR does not look like a core checkout: ${params.dir}.`);
-	return null;
-}
-async function resolveGlobalManager(params) {
-	const runCommand = createGlobalCommandRunner();
-	if (params.installKind === "package") {
-		const detected = await detectGlobalInstallManagerForRoot(runCommand, params.root, params.timeoutMs);
-		if (detected) return detected;
-	}
-	return await detectGlobalInstallManagerByPresence(runCommand, params.timeoutMs) ?? "npm";
-}
-const COMPLETION_CACHE_WRITE_TIMEOUT_MS = 3e4;
-async function tryWriteCompletionCache(root, jsonMode) {
-	const binPath = path.join(root, "genesis.mjs");
-	if (!await pathExists(binPath)) return;
-	const result = spawnSync(resolveNodeRunner(), [
-		binPath,
-		"completion",
-		"--write-state"
-	], {
-		cwd: root,
-		env: process.env,
-		encoding: "utf-8",
-		timeout: COMPLETION_CACHE_WRITE_TIMEOUT_MS
-	});
-	if (result.error) {
-		if (!jsonMode) defaultRuntime.log(theme.warn(`Completion cache update failed: ${String(result.error)}`));
-		return;
-	}
-	if (result.status !== 0 && !jsonMode) {
-		const stderr = (result.stderr ?? "").trim();
-		const detail = stderr ? ` (${stderr})` : "";
-		defaultRuntime.log(theme.warn(`Completion cache update failed${detail}.`));
-	}
-}
-function createGlobalCommandRunner() {
-	return async (argv, options) => {
-		const res = await runCommandWithTimeout(argv, options);
-		return {
-			stdout: res.stdout,
-			stderr: res.stderr,
-			code: res.code
-		};
-	};
-}
-//#endregion
-//#region src/cli/update-cli/status.ts
-function formatGitStatusLine(params) {
-	const shortSha = params.sha ? params.sha.slice(0, 8) : null;
-	const branch = params.branch && params.branch !== "HEAD" ? params.branch : null;
-	const tag = params.tag;
-	return [
-		branch ?? (tag ? "detached" : "git"),
-		tag ? `tag ${tag}` : null,
-		shortSha ? `@ ${shortSha}` : null
-	].filter(Boolean).join(" · ");
-}
-async function updateStatusCommand(opts) {
-	const timeoutMs = parseTimeoutMsOrExit(opts.timeout);
-	if (timeoutMs === null) return;
-	const root = await resolveUpdateRoot();
-	const configSnapshot = await readConfigFileSnapshot();
-	const configChannel = configSnapshot.valid ? normalizeUpdateChannel(configSnapshot.config.update?.channel) : null;
-	const update = await checkUpdateStatus({
-		root,
-		timeoutMs: timeoutMs ?? 3500,
-		fetchGit: true,
-		includeRegistry: true
-	});
-	const channelInfo = resolveUpdateChannelDisplay({
-		configChannel,
-		installKind: update.installKind,
-		gitTag: update.git?.tag ?? null,
-		gitBranch: update.git?.branch ?? null
-	});
-	const channelLabel = channelInfo.label;
-	const gitLabel = update.installKind === "git" ? formatGitStatusLine({
-		branch: update.git?.branch ?? null,
-		tag: update.git?.tag ?? null,
-		sha: update.git?.sha ?? null
-	}) : null;
-	const updateAvailability = resolveUpdateAvailability(update);
-	const updateLine = formatUpdateOneLiner(update).replace(/^Update:\s*/i, "");
-	if (opts.json) {
-		defaultRuntime.writeJson({
-			update,
-			channel: {
-				value: channelInfo.channel,
-				source: channelInfo.source,
-				label: channelLabel,
-				config: configChannel
-			},
-			availability: updateAvailability
-		});
-		return;
-	}
-	const tableWidth = getTerminalTableWidth();
-	const rows = [
-		{
-			Item: "Install",
-			Value: update.installKind === "git" ? `git (${update.root ?? "unknown"})` : update.installKind === "package" ? update.packageManager : "unknown"
-		},
-		{
-			Item: "Channel",
-			Value: channelLabel
-		},
-		...gitLabel ? [{
-			Item: "Git",
-			Value: gitLabel
-		}] : [],
-		{
-			Item: "Update",
-			Value: updateAvailability.available ? theme.warn(`available · ${updateLine}`) : updateLine
-		}
-	];
-	defaultRuntime.log(theme.heading("Genesis update status"));
-	defaultRuntime.log("");
-	defaultRuntime.log(renderTable({
-		width: tableWidth,
-		columns: [{
-			key: "Item",
-			header: "Item",
-			minWidth: 10
-		}, {
-			key: "Value",
-			header: "Value",
-			flex: true,
-			minWidth: 24
-		}],
-		rows
-	}).trimEnd());
-	defaultRuntime.log("");
-	const updateHint = formatUpdateAvailableHint(update);
-	if (updateHint) defaultRuntime.log(theme.warn(updateHint));
-}
-//#endregion
-//#region src/cli/update-cli/progress.ts
-const STEP_LABELS = {
-	"clean check": "Working directory is clean",
-	"upstream check": "Upstream branch exists",
-	"git fetch": "Fetching latest changes",
-	"git rebase": "Rebasing onto target commit",
-	"git rev-parse @{upstream}": "Resolving upstream commit",
-	"git rev-list": "Enumerating candidate commits",
-	"git clone": "Cloning git checkout",
-	"preflight worktree": "Preparing preflight worktree",
-	"preflight cleanup": "Cleaning preflight worktree",
-	"deps install": "Installing dependencies",
-	build: "Building",
-	"ui:build": "Building UI assets",
-	"ui:build (post-doctor repair)": "Restoring missing UI assets",
-	"ui assets verify": "Validating UI assets",
-	"genesis doctor entry": "Checking doctor entrypoint",
-	"genesis doctor": "Running doctor checks",
-	"git rev-parse HEAD (after)": "Verifying update",
-	"global update": "Updating via package manager",
-	"global update (omit optional)": "Retrying update without optional deps",
-	"global install": "Installing global package"
-};
-const GENESIS_NPM_PACKAGE_NAME = "@pixelzx/genesis";
-function getStepLabel(step) {
-	return STEP_LABELS[step.name] ?? step.name;
-}
-function inferUpdateFailureHints(result) {
-	if (result.status !== "error") return [];
-	if (result.reason === "pnpm-corepack-missing") return ["This pnpm checkout could not auto-enable pnpm because corepack is missing.", "Install pnpm manually or install Node with corepack available, then rerun the update command."];
-	if (result.reason === "pnpm-corepack-enable-failed") return ["This pnpm checkout could not auto-enable pnpm via corepack.", "Run `corepack enable` manually or install pnpm manually, then rerun the update command."];
-	if (result.reason === "pnpm-npm-bootstrap-failed") return ["This pnpm checkout could not bootstrap pnpm from npm automatically.", "Install pnpm manually, then rerun the update command."];
-	if (result.reason === "preferred-manager-unavailable") return ["This checkout requires its declared package manager and the updater could not find it.", "Install the missing package manager manually, then rerun the update command."];
-	if (result.mode !== "npm") return [];
-	const failedStep = [...result.steps].toReversed().find((step) => step.exitCode !== 0);
-	if (!failedStep) return [];
-	const stderr = normalizeLowercaseStringOrEmpty(failedStep.stderrTail);
-	const hints = [];
-	if (failedStep.name.startsWith("global update") && stderr.includes("eacces")) {
-		hints.push("Detected permission failure (EACCES). Re-run with a writable global prefix or sudo (for system-managed Node installs).");
-		hints.push(`Example: npm config set prefix ~/.local && npm i -g ${GENESIS_NPM_PACKAGE_NAME}@latest`);
-	}
-	if (failedStep.name.startsWith("global update") && (stderr.includes("node-gyp") || stderr.includes("prebuild"))) {
-		hints.push("Detected native optional dependency build failure. The updater retries with --omit=optional automatically.");
-		hints.push(`If it still fails: npm i -g ${GENESIS_NPM_PACKAGE_NAME}@latest --omit=optional`);
-	}
-	return hints;
-}
-function createUpdateProgress(enabled) {
-	if (!enabled) return {
-		progress: {},
-		stop: () => {}
-	};
-	let currentSpinner = null;
-	return {
-		progress: {
-			onStepStart: (step) => {
-				currentSpinner = spinner();
-				currentSpinner.start(theme.accent(getStepLabel(step)));
-			},
-			onStepComplete: (step) => {
-				if (!currentSpinner) return;
-				const label = getStepLabel(step);
-				const duration = theme.muted(`(${formatDurationPrecise(step.durationMs)})`);
-				const icon = step.exitCode === 0 ? theme.success("✓") : theme.error("✗");
-				currentSpinner.stop(`${icon} ${label} ${duration}`);
-				currentSpinner = null;
-				if (step.exitCode !== 0 && step.stderrTail) {
-					const lines = step.stderrTail.split("\n").slice(-10);
-					for (const line of lines) if (line.trim()) defaultRuntime.log(`    ${theme.error(line)}`);
-				}
-			}
-		},
-		stop: () => {
-			if (currentSpinner) {
-				currentSpinner.stop();
-				currentSpinner = null;
-			}
-		}
-	};
-}
-function formatStepStatus(exitCode) {
-	if (exitCode === 0) return theme.success("✓");
-	if (exitCode === null) return theme.warn("?");
-	return theme.error("✗");
-}
-function printResult(result, opts) {
-	if (opts.json) {
-		defaultRuntime.writeJson(result);
-		return;
-	}
-	const statusColor = result.status === "ok" ? theme.success : result.status === "skipped" ? theme.warn : theme.error;
-	defaultRuntime.log("");
-	defaultRuntime.log(`${theme.heading("Update Result:")} ${statusColor(result.status.toUpperCase())}`);
-	if (result.root) defaultRuntime.log(`  Root: ${theme.muted(result.root)}`);
-	if (result.reason) defaultRuntime.log(`  Reason: ${theme.muted(result.reason)}`);
-	if (result.before?.version || result.before?.sha) {
-		const before = result.before.version ?? result.before.sha?.slice(0, 8) ?? "";
-		defaultRuntime.log(`  Before: ${theme.muted(before)}`);
-	}
-	if (result.after?.version || result.after?.sha) {
-		const after = result.after.version ?? result.after.sha?.slice(0, 8) ?? "";
-		defaultRuntime.log(`  After: ${theme.muted(after)}`);
-	}
-	if (!opts.hideSteps && result.steps.length > 0) {
-		defaultRuntime.log("");
-		defaultRuntime.log(theme.heading("Steps:"));
-		for (const step of result.steps) {
-			const status = formatStepStatus(step.exitCode);
-			const duration = theme.muted(`(${formatDurationPrecise(step.durationMs)})`);
-			defaultRuntime.log(`  ${status} ${step.name} ${duration}`);
-			if (step.exitCode !== 0 && step.stderrTail) {
-				const lines = step.stderrTail.split("\n").slice(0, 5);
-				for (const line of lines) if (line.trim()) defaultRuntime.log(`      ${theme.error(line)}`);
-			}
-		}
-	}
-	const hints = inferUpdateFailureHints(result);
-	if (hints.length > 0) {
-		defaultRuntime.log("");
-		defaultRuntime.log(theme.heading("Recovery hints:"));
-		for (const hint of hints) defaultRuntime.log(`  - ${theme.warn(hint)}`);
-	}
-	defaultRuntime.log("");
-	defaultRuntime.log(`Total time: ${theme.muted(formatDurationPrecise(result.durationMs))}`);
-}
-//#endregion
-//#region src/cli/update-cli/restart-helper.ts
-/**
-* Shell-escape a string for embedding in single-quoted shell arguments.
-* Replaces every `'` with `'\''` (end quote, escaped quote, resume quote).
-* For batch scripts, validates against special characters instead.
-*/
-function shellEscape(value) {
-	return value.replace(/'/g, "'\\''");
-}
-/** Validates a string is safe for embedding in a batch (cmd.exe) script. */
-function isBatchSafe(value) {
-	return /^[A-Za-z0-9 _\-().]+$/.test(value);
-}
-function resolveSystemdUnit(env) {
-	const override = normalizeOptionalString(env.GENESIS_SYSTEMD_UNIT);
-	if (override) return override.endsWith(".service") ? override : `${override}.service`;
-	return `${resolveGatewaySystemdServiceName(env.GENESIS_PROFILE)}.service`;
-}
-function resolveLaunchdLabel(env) {
-	const override = normalizeOptionalString(env.GENESIS_LAUNCHD_LABEL);
-	if (override) return override;
-	return resolveGatewayLaunchAgentLabel(env.GENESIS_PROFILE);
-}
-function resolveWindowsTaskName(env) {
-	const override = env.GENESIS_WINDOWS_TASK_NAME?.trim();
-	if (override) return override;
-	return resolveGatewayWindowsTaskName(env.GENESIS_PROFILE);
-}
-/**
-* Prepares a standalone script to restart the gateway service.
-* This script is written to a temporary directory and does not depend on
-* the installed package files, ensuring restart capability even if the
-* update process temporarily removes or corrupts installation files.
-*/
-async function prepareRestartScript(env = process.env, gatewayPort = DEFAULT_GATEWAY_PORT) {
-	const tmpDir = os.tmpdir();
-	const timestamp = Date.now();
-	const platform = process.platform;
-	let scriptContent = "";
-	let filename = "";
-	try {
-		if (platform === "linux") {
-			const escaped = shellEscape(resolveSystemdUnit(env));
-			const logSetup = renderPosixRestartLogSetup({
-				...process.env,
-				...env
-			});
-			filename = `genesis-restart-${timestamp}.sh`;
-			scriptContent = `#!/bin/sh
-# Standalone restart script — survives parent process termination.
-# Wait briefly to ensure file locks are released after update.
-sleep 1
-${logSetup}
-printf '[%s] genesis restart attempt source=update target=%s\\n' "$(date -u +%FT%TZ)" '${escaped}' >&2
-if systemctl --user restart '${escaped}'; then
-  status=0
-  printf '[%s] genesis restart done source=update\\n' "$(date -u +%FT%TZ)" >&2
-else
-  status=$?
-  printf '[%s] genesis restart failed source=update status=%s\\n' "$(date -u +%FT%TZ)" "$status" >&2
-fi
-# Self-cleanup
-rm -f "$0"
-exit "$status"
-`;
-		} else if (platform === "darwin") {
-			const label = resolveLaunchdLabel(env);
-			const escaped = shellEscape(label);
-			const uid = process.getuid ? process.getuid() : 501;
-			const home = normalizeOptionalString(env.HOME) || process.env.HOME || os.homedir();
-			const escapedPlistPath = shellEscape(path.join(home, "Library", "LaunchAgents", `${label}.plist`));
-			const logSetup = renderPosixRestartLogSetup({
-				...process.env,
-				...env
-			});
-			filename = `genesis-restart-${timestamp}.sh`;
-			scriptContent = `#!/bin/sh
-# Standalone restart script — survives parent process termination.
-# Wait briefly to ensure file locks are released after update.
-sleep 1
-# Capture launchctl output so bootstrap/kickstart failures leave a durable
-# audit trail. Log setup is best-effort: restart must still run if the log path
-# is temporarily unavailable.
-${logSetup}
-printf '[%s] genesis restart attempt source=update target=%s\\n' "$(date -u +%FT%TZ)" '${shellEscapeRestartLogValue(label)}' >&2
-# Try kickstart first (works when the service is still registered).
-# If it fails (e.g. after bootout), clear any persisted disabled state,
-# then re-register via bootstrap and kickstart. The final status is captured
-# before self-cleanup so a genuine failure remains observable.
-status=0
-if ! launchctl kickstart -k 'gui/${uid}/${escaped}'; then
-  launchctl enable 'gui/${uid}/${escaped}'
-  launchctl bootstrap 'gui/${uid}' '${escapedPlistPath}'
-  launchctl kickstart -k 'gui/${uid}/${escaped}'
-  status=$?
-fi
-if [ "$status" -eq 0 ]; then
-  printf '[%s] genesis restart done source=update\\n' "$(date -u +%FT%TZ)" >&2
-else
-  printf '[%s] genesis restart failed source=update status=%s\\n' "$(date -u +%FT%TZ)" "$status" >&2
-fi
-# Self-cleanup (log is retained under the Genesis state logs directory).
-rm -f "$0"
-exit "$status"
-`;
-		} else if (platform === "win32") {
-			const taskName = resolveWindowsTaskName(env);
-			if (!isBatchSafe(taskName)) return null;
-			const port = Number.isFinite(gatewayPort) && gatewayPort > 0 ? gatewayPort : DEFAULT_GATEWAY_PORT;
-			const restartLog = renderCmdRestartLogSetup({
-				...process.env,
-				...env
-			});
-			filename = `genesis-restart-${timestamp}.bat`;
-			scriptContent = `@echo off
-REM Standalone restart script — survives parent process termination.
-REM Wait briefly to ensure file locks are released after update.
-timeout /t 2 /nobreak >nul
-${restartLog.lines.join("\r\n")}
->> ${restartLog.quotedLogPath} 2>&1 echo [%DATE% %TIME%] genesis restart attempt source=update target=${taskName}
-schtasks /End /TN "${taskName}" >> ${restartLog.quotedLogPath} 2>&1
-REM Poll for gateway port release before rerun; force-kill listener if stuck.
-set /a attempts=0
-:wait_for_port_release
-set /a attempts+=1
-netstat -ano | findstr /R /C:":${port} .*LISTENING" >nul
-if errorlevel 1 goto port_released
-if %attempts% GEQ 10 goto force_kill_listener
-timeout /t 1 /nobreak >nul
-goto wait_for_port_release
-:force_kill_listener
-for /f "tokens=5" %%P in ('netstat -ano ^| findstr /R /C:":${port} .*LISTENING"') do (
-  taskkill /F /PID %%P >> ${restartLog.quotedLogPath} 2>&1
-  goto port_released
-)
-:port_released
-schtasks /Run /TN "${taskName}" >> ${restartLog.quotedLogPath} 2>&1
-set "status=%ERRORLEVEL%"
-if not "%status%"=="0" (
-  >> ${restartLog.quotedLogPath} 2>&1 echo [%DATE% %TIME%] genesis restart failed source=update status=%status%
-) else (
-  >> ${restartLog.quotedLogPath} 2>&1 echo [%DATE% %TIME%] genesis restart done source=update
-)
-REM Self-cleanup
-del "%~f0"
-exit /b %status%
-`;
-		} else return null;
-		const scriptPath = path.join(tmpDir, filename);
-		await fs.writeFile(scriptPath, scriptContent, { mode: 493 });
-		return scriptPath;
-	} catch {
-		return null;
-	}
-}
-/**
-* Executes the prepared restart script as a **detached** process.
-*
-* The script must outlive the CLI process because the CLI itself is part
-* of the service being restarted — `systemctl restart` / `launchctl
-* kickstart -k` will terminate the current process tree.  Using
-* `spawn({ detached: true })` + `unref()` ensures the script survives
-* the parent's exit.
-*
-* Resolves immediately after spawning; the script runs independently.
-*/
-async function runRestartScript(scriptPath) {
-	const isWindows = process.platform === "win32";
-	spawn(isWindows ? "cmd.exe" : "/bin/sh", isWindows ? [
-		"/d",
-		"/s",
-		"/c",
-		quoteCmdScriptArg(scriptPath)
-	] : [scriptPath], {
-		detached: true,
-		stdio: "ignore",
-		windowsHide: true
-	}).unref();
-}
-//#endregion
-//#region src/cli/update-cli/suppress-deprecations.ts
-/**
-* Suppress Node.js deprecation warnings.
-*
-* On Node.js v23+ `process.noDeprecation` may be a read-only property
-* (defined via a getter on the prototype with no setter), so the
-* assignment can throw. We fall back to the environment variable which
-* achieves the same effect.
-*/
-function suppressDeprecations() {
-	try {
-		process.noDeprecation = true;
-	} catch {}
-	process.env.NODE_NO_WARNINGS = "1";
-}
-//#endregion
-//#region src/cli/update-cli/update-command.ts
-const CLI_NAME = resolveCliName();
-const SERVICE_REFRESH_TIMEOUT_MS = 6e4;
-const POST_CORE_UPDATE_ENV = "GENESIS_UPDATE_POST_CORE";
-const POST_CORE_UPDATE_CHANNEL_ENV = "GENESIS_UPDATE_POST_CORE_CHANNEL";
-const POST_CORE_UPDATE_RESULT_PATH_ENV = "GENESIS_UPDATE_POST_CORE_RESULT_PATH";
-const SERVICE_REFRESH_PATH_ENV_KEYS = [
-	"GENESIS_HOME",
-	"GENESIS_STATE_DIR",
-	"GENESIS_CONFIG_PATH"
-];
-const UPDATE_QUIPS = [
-	"Leveled up! New skills unlocked. You're welcome.",
-	"Fresh code, same lobster. Miss me?",
-	"Back and better. Did you even notice I was gone?",
-	"Update complete. I learned some new tricks while I was out.",
-	"Upgraded! Now with 23% more sass.",
-	"I've evolved. Try to keep up.",
-	"New version, who dis? Oh right, still me but shinier.",
-	"Patched, polished, and ready to pinch. Let's go.",
-	"The lobster has molted. Harder shell, sharper claws.",
-	"Update done! Check the changelog or just trust me, it's good.",
-	"Reborn from the boiling waters of npm. Stronger now.",
-	"I went away and came back smarter. You should try it sometime.",
-	"Update complete. The bugs feared me, so they left.",
-	"New version installed. Old version sends its regards.",
-	"Firmware fresh. Brain wrinkles: increased.",
-	"I've seen things you wouldn't believe. Anyway, I'm updated.",
-	"Back online. The changelog is long but our friendship is longer.",
-	"Upgraded! Peter fixed stuff. Blame him if it breaks.",
-	"Molting complete. Please don't look at my soft shell phase.",
-	"Version bump! Same chaos energy, fewer crashes (probably)."
-];
-function pickUpdateQuip() {
-	return UPDATE_QUIPS[Math.floor(Math.random() * UPDATE_QUIPS.length)] ?? "Update complete.";
-}
-function isPackageManagerUpdateMode(mode) {
-	return mode === "npm" || mode === "pnpm" || mode === "bun";
-}
-function formatCommandFailure(stdout, stderr) {
-	const detail = (stderr || stdout).trim();
-	if (!detail) return "command returned a non-zero exit code";
-	return detail.split("\n").slice(-3).join("\n");
-}
-function tryResolveInvocationCwd() {
-	try {
-		return process.cwd();
-	} catch {
-		return;
-	}
-}
-async function resolvePackageRuntimePreflightError(params) {
-	if (!canResolveRegistryVersionForPackageTarget(params.tag)) return null;
-	const target = params.tag.trim();
-	if (!target) return null;
-	const status = await fetchNpmPackageTargetStatus({
-		packageName: params.packageName,
-		target,
-		timeoutMs: params.timeoutMs
-	});
-	if (status.error) return null;
-	if (nodeVersionSatisfiesEngine(process.versions.node ?? null, status.nodeEngine) !== false) return null;
-	const targetLabel = status.version ?? target;
-	return [
-		`Node ${process.versions.node ?? "unknown"} is too old for ${params.packageName}@${targetLabel}.`,
-		`The requested package requires ${status.nodeEngine}.`,
-		"Upgrade Node to 22.14+ or Node 24, then rerun `genesis update`.",
-		`Bare \`npm i -g ${params.packageName}\` can silently install an older compatible release.`,
-		`After upgrading Node, use \`npm i -g ${params.packageName}@latest\`.`
-	].join("\n");
-}
-function resolveServiceRefreshEnv(env, invocationCwd) {
-	const resolvedEnv = { ...env };
-	for (const key of SERVICE_REFRESH_PATH_ENV_KEYS) {
-		const rawValue = resolvedEnv[key]?.trim();
-		if (!rawValue) continue;
-		if (rawValue.startsWith("~") || path.isAbsolute(rawValue) || path.win32.isAbsolute(rawValue)) {
-			resolvedEnv[key] = rawValue;
-			continue;
-		}
-		if (!invocationCwd) {
-			resolvedEnv[key] = rawValue;
-			continue;
-		}
-		resolvedEnv[key] = path.resolve(invocationCwd, rawValue);
-	}
-	return resolvedEnv;
-}
-function printDryRunPreview(preview, jsonMode) {
-	if (jsonMode) {
-		defaultRuntime.writeJson(preview);
-		return;
-	}
-	defaultRuntime.log(theme.heading("Update dry-run"));
-	defaultRuntime.log(theme.muted("No changes were applied."));
-	defaultRuntime.log("");
-	defaultRuntime.log(`  Root: ${theme.muted(preview.root)}`);
-	defaultRuntime.log(`  Install kind: ${theme.muted(preview.installKind)}`);
-	defaultRuntime.log(`  Mode: ${theme.muted(preview.mode)}`);
-	defaultRuntime.log(`  Channel: ${theme.muted(preview.effectiveChannel)}`);
-	defaultRuntime.log(`  Tag/spec: ${theme.muted(preview.tag)}`);
-	if (preview.currentVersion) defaultRuntime.log(`  Current version: ${theme.muted(preview.currentVersion)}`);
-	if (preview.targetVersion) defaultRuntime.log(`  Target version: ${theme.muted(preview.targetVersion)}`);
-	if (preview.downgradeRisk) defaultRuntime.log(theme.warn("  Downgrade confirmation would be required in a real run."));
-	defaultRuntime.log("");
-	defaultRuntime.log(theme.heading("Planned actions:"));
-	for (const action of preview.actions) defaultRuntime.log(`  - ${action}`);
-	if (preview.notes.length > 0) {
-		defaultRuntime.log("");
-		defaultRuntime.log(theme.heading("Notes:"));
-		for (const note of preview.notes) defaultRuntime.log(`  - ${theme.muted(note)}`);
-	}
-}
-async function refreshGatewayServiceEnv(params) {
-	const args = [
-		"gateway",
-		"install",
-		"--force"
-	];
-	if (params.jsonMode) args.push("--json");
-	const entrypoint = await resolveGatewayInstallEntrypoint(params.result.root);
-	if (entrypoint) {
-		const res = await runCommandWithTimeout([
-			resolveNodeRunner(),
-			entrypoint,
-			...args
-		], {
-			cwd: params.result.root,
-			env: resolveServiceRefreshEnv(process.env, params.invocationCwd),
-			timeoutMs: SERVICE_REFRESH_TIMEOUT_MS
-		});
-		if (res.code === 0) return;
-		throw new Error(`updated install refresh failed (${entrypoint}): ${formatCommandFailure(res.stdout, res.stderr)}`);
-	}
-	await runDaemonInstall({
-		force: true,
-		json: params.jsonMode || void 0
-	});
-}
-async function tryInstallShellCompletion(opts) {
-	if (opts.jsonMode || !process.stdin.isTTY) return;
-	const status = await checkShellCompletionStatus(CLI_NAME);
-	if (status.usesSlowPattern) {
-		defaultRuntime.log(theme.muted("Upgrading shell completion to cached version..."));
-		if (await ensureCompletionCacheExists(CLI_NAME)) await installCompletion(status.shell, true, CLI_NAME);
-		return;
-	}
-	if (status.profileInstalled && !status.cacheExists) {
-		defaultRuntime.log(theme.muted("Regenerating shell completion cache..."));
-		await ensureCompletionCacheExists(CLI_NAME);
-		return;
-	}
-	if (!status.profileInstalled) {
-		defaultRuntime.log("");
-		defaultRuntime.log(theme.heading("Shell completion"));
-		const shouldInstall = await confirm({
-			message: stylePromptMessage(`Enable ${status.shell} shell completion for ${CLI_NAME}?`),
-			initialValue: true
-		});
-		if (isCancel(shouldInstall) || !shouldInstall) {
-			if (!opts.skipPrompt) defaultRuntime.log(theme.muted(`Skipped. Run \`${replaceCliName(formatCliCommand("genesis completion --install"), CLI_NAME)}\` later to enable.`));
-			return;
-		}
-		if (!await ensureCompletionCacheExists(CLI_NAME)) {
-			defaultRuntime.log(theme.warn("Failed to generate completion cache."));
-			return;
-		}
-		await installCompletion(status.shell, opts.skipPrompt, CLI_NAME);
-	}
-}
-async function runPackageInstallUpdate(params) {
-	const manager = await resolveGlobalManager({
-		root: params.root,
-		installKind: params.installKind,
-		timeoutMs: params.timeoutMs
-	});
-	const installEnv = await createGlobalInstallEnv();
-	const runCommand = createGlobalCommandRunner();
-	const installTarget = await resolveGlobalInstallTarget({
-		manager,
-		runCommand,
-		timeoutMs: params.timeoutMs,
-		pkgRoot: params.root
-	});
-	const pkgRoot = installTarget.packageRoot;
-	const packageName = (pkgRoot ? await readPackageName(pkgRoot) : await readPackageName(params.root)) ?? "@pixelzx/genesis";
-	const installSpec = resolveGlobalInstallSpec({
-		packageName,
-		tag: params.tag,
-		env: installEnv
-	});
-	const beforeVersion = pkgRoot ? await readPackageVersion(pkgRoot) : null;
-	if (pkgRoot) await cleanupGlobalRenameDirs({
-		globalRoot: path.dirname(pkgRoot),
-		packageName
-	});
-	const updateStep = await runUpdateStep({
-		name: "global update",
-		argv: globalInstallArgs(installTarget, installSpec),
-		env: installEnv,
-		timeoutMs: params.timeoutMs,
-		progress: params.progress
-	});
-	const steps = [updateStep];
-	let finalInstallStep = updateStep;
-	if (updateStep.exitCode !== 0) {
-		const fallbackArgv = globalInstallFallbackArgs(installTarget, installSpec);
-		if (fallbackArgv) {
-			const fallbackStep = await runUpdateStep({
-				name: "global update (omit optional)",
-				argv: fallbackArgv,
-				env: installEnv,
-				timeoutMs: params.timeoutMs,
-				progress: params.progress
-			});
-			steps.push(fallbackStep);
-			finalInstallStep = fallbackStep;
-		}
-	}
-	let afterVersion = beforeVersion;
-	const verifiedPackageRoot = (await resolveGlobalInstallTarget({
-		manager: installTarget,
-		runCommand,
-		timeoutMs: params.timeoutMs,
-		pkgRoot
-	})).packageRoot ?? pkgRoot;
-	if (verifiedPackageRoot) {
-		afterVersion = await readPackageVersion(verifiedPackageRoot);
-		const verificationErrors = await collectInstalledGlobalPackageErrors({
-			packageRoot: verifiedPackageRoot,
-			expectedVersion: resolveExpectedInstalledVersionFromSpec(packageName, installSpec)
-		});
-		if (verificationErrors.length > 0) steps.push({
-			name: "global install verify",
-			command: `verify ${verifiedPackageRoot}`,
-			cwd: verifiedPackageRoot,
-			durationMs: 0,
-			exitCode: 1,
-			stderrTail: verificationErrors.join("\n"),
-			stdoutTail: null
-		});
-		const entryPath = await resolveGatewayInstallEntrypoint(verifiedPackageRoot);
-		if (entryPath) {
-			const doctorStep = await runUpdateStep({
-				name: `${CLI_NAME} doctor`,
-				argv: [
-					resolveNodeRunner(),
-					entryPath,
-					"doctor",
-					"--non-interactive"
-				],
-				env: {
-					...process.env,
-					GENESIS_UPDATE_IN_PROGRESS: "1"
-				},
-				timeoutMs: params.timeoutMs,
-				progress: params.progress
-			});
-			steps.push(doctorStep);
-		}
-	}
-	const failedStep = finalInstallStep.exitCode !== 0 ? finalInstallStep : steps.find((step) => step.name === "global install verify" && step.exitCode !== 0) ?? steps.find((step) => step.name === `${CLI_NAME} doctor` && step.exitCode !== 0);
-	return {
-		status: failedStep ? "error" : "ok",
-		mode: manager,
-		root: verifiedPackageRoot ?? params.root,
-		reason: failedStep ? failedStep.name : void 0,
-		before: { version: beforeVersion },
-		after: { version: afterVersion },
-		steps,
-		durationMs: Date.now() - params.startedAt
-	};
-}
-async function runGitUpdate(params) {
-	const updateRoot = params.switchToGit ? resolveGitInstallDir() : params.root;
-	const effectiveTimeout = params.timeoutMs ?? 20 * 6e4;
-	const installEnv = await createGlobalInstallEnv();
-	const cloneStep = params.switchToGit ? await ensureGitCheckout({
-		dir: updateRoot,
-		env: installEnv,
-		timeoutMs: effectiveTimeout,
-		progress: params.progress
-	}) : null;
-	if (cloneStep && cloneStep.exitCode !== 0) {
-		const result = {
-			status: "error",
-			mode: "git",
-			root: updateRoot,
-			reason: cloneStep.name,
-			steps: [cloneStep],
-			durationMs: Date.now() - params.startedAt
-		};
-		params.stop();
-		printResult(result, {
-			...params.opts,
-			hideSteps: params.showProgress
-		});
-		defaultRuntime.exit(1);
-		return result;
-	}
-	const updateResult = await runGatewayUpdate({
-		cwd: updateRoot,
-		argv1: params.switchToGit ? void 0 : process.argv[1],
-		timeoutMs: params.timeoutMs,
-		progress: params.progress,
-		channel: params.channel,
-		tag: params.tag,
-		devTargetRef: params.devTargetRef
-	});
-	const steps = [...cloneStep ? [cloneStep] : [], ...updateResult.steps];
-	if (params.switchToGit && updateResult.status === "ok") {
-		const installStep = await runUpdateStep({
-			name: "global install",
-			argv: globalInstallArgs(await resolveGlobalInstallTarget({
-				manager: await resolveGlobalManager({
-					root: params.root,
-					installKind: params.installKind,
-					timeoutMs: effectiveTimeout
-				}),
-				runCommand: createGlobalCommandRunner(),
-				timeoutMs: effectiveTimeout,
-				pkgRoot: params.root
-			}), updateRoot),
-			cwd: updateRoot,
-			env: installEnv,
-			timeoutMs: effectiveTimeout,
-			progress: params.progress
-		});
-		steps.push(installStep);
-		const failedStep = installStep.exitCode !== 0 ? installStep : null;
-		return {
-			...updateResult,
-			status: updateResult.status === "ok" && !failedStep ? "ok" : "error",
-			steps,
-			durationMs: Date.now() - params.startedAt
-		};
-	}
-	return {
-		...updateResult,
-		steps,
-		durationMs: Date.now() - params.startedAt
-	};
-}
-async function updatePluginsAfterCoreUpdate(params) {
-	if (!params.configSnapshot.valid) {
-		if (!params.opts.json) defaultRuntime.log(theme.warn("Skipping plugin updates: config is invalid."));
-		return {
-			status: "skipped",
-			reason: "invalid-config",
-			changed: false,
-			sync: {
-				changed: false,
-				switchedToBundled: [],
-				switchedToNpm: [],
-				warnings: [],
-				errors: []
-			},
-			npm: {
-				changed: false,
-				outcomes: []
-			},
-			integrityDrifts: []
-		};
-	}
-	const pluginLogger = params.opts.json ? {} : {
-		info: (msg) => defaultRuntime.log(msg),
-		warn: (msg) => defaultRuntime.log(theme.warn(msg)),
-		error: (msg) => defaultRuntime.log(theme.error(msg))
-	};
-	if (!params.opts.json) {
-		defaultRuntime.log("");
-		defaultRuntime.log(theme.heading("Updating plugins..."));
-	}
-	const syncResult = await syncPluginsForUpdateChannel({
-		config: params.configSnapshot.sourceConfig,
-		channel: params.channel,
-		workspaceDir: params.root,
-		logger: pluginLogger
-	});
-	let pluginConfig = syncResult.config;
-	const integrityDrifts = [];
-	const npmResult = await updateNpmInstalledPlugins({
-		config: pluginConfig,
-		skipIds: new Set(syncResult.summary.switchedToNpm),
-		logger: pluginLogger,
-		onIntegrityDrift: async (drift) => {
-			integrityDrifts.push({
-				pluginId: drift.pluginId,
-				spec: drift.spec,
-				expectedIntegrity: drift.expectedIntegrity,
-				actualIntegrity: drift.actualIntegrity,
-				...drift.resolvedSpec ? { resolvedSpec: drift.resolvedSpec } : {},
-				...drift.resolvedVersion ? { resolvedVersion: drift.resolvedVersion } : {},
-				action: "aborted"
-			});
-			if (!params.opts.json) {
-				const specLabel = drift.resolvedSpec ?? drift.spec;
-				defaultRuntime.log(theme.warn(`Integrity drift detected for "${drift.pluginId}" (${specLabel})\nExpected: ${drift.expectedIntegrity}\nActual:   ${drift.actualIntegrity}
-Plugin update aborted. Reinstall the plugin only if you trust the new artifact.`));
-			}
-			return false;
-		}
-	});
-	pluginConfig = npmResult.config;
-	if (syncResult.changed || npmResult.changed) await replaceConfigFile({
-		nextConfig: pluginConfig,
-		baseHash: params.configSnapshot.hash
-	});
-	if (params.opts.json) return {
-		status: syncResult.summary.errors.length > 0 || npmResult.outcomes.some((outcome) => outcome.status === "error") ? "error" : "ok",
-		changed: syncResult.changed || npmResult.changed,
-		sync: {
-			changed: syncResult.changed,
-			switchedToBundled: syncResult.summary.switchedToBundled,
-			switchedToNpm: syncResult.summary.switchedToNpm,
-			warnings: syncResult.summary.warnings,
-			errors: syncResult.summary.errors
-		},
-		npm: {
-			changed: npmResult.changed,
-			outcomes: npmResult.outcomes
-		},
-		integrityDrifts
-	};
-	const summarizeList = (list) => {
-		if (list.length <= 6) return list.join(", ");
-		return `${list.slice(0, 6).join(", ")} +${list.length - 6} more`;
-	};
-	if (syncResult.summary.switchedToBundled.length > 0) defaultRuntime.log(theme.muted(`Switched to bundled plugins: ${summarizeList(syncResult.summary.switchedToBundled)}.`));
-	if (syncResult.summary.switchedToNpm.length > 0) defaultRuntime.log(theme.muted(`Restored npm plugins: ${summarizeList(syncResult.summary.switchedToNpm)}.`));
-	for (const warning of syncResult.summary.warnings) defaultRuntime.log(theme.warn(warning));
-	for (const error of syncResult.summary.errors) defaultRuntime.log(theme.error(error));
-	const updated = npmResult.outcomes.filter((entry) => entry.status === "updated").length;
-	const unchanged = npmResult.outcomes.filter((entry) => entry.status === "unchanged").length;
-	const failed = npmResult.outcomes.filter((entry) => entry.status === "error").length;
-	const skipped = npmResult.outcomes.filter((entry) => entry.status === "skipped").length;
-	if (npmResult.outcomes.length === 0) defaultRuntime.log(theme.muted("No plugin updates needed."));
-	else {
-		const parts = [`${updated} updated`, `${unchanged} unchanged`];
-		if (failed > 0) parts.push(`${failed} failed`);
-		if (skipped > 0) parts.push(`${skipped} skipped`);
-		defaultRuntime.log(theme.muted(`npm plugins: ${parts.join(", ")}.`));
-	}
-	for (const outcome of npmResult.outcomes) {
-		if (outcome.status !== "error") continue;
-		defaultRuntime.log(theme.error(outcome.message));
-	}
-	return {
-		status: syncResult.summary.errors.length > 0 || npmResult.outcomes.some((outcome) => outcome.status === "error") ? "error" : "ok",
-		changed: syncResult.changed || npmResult.changed,
-		sync: {
-			changed: syncResult.changed,
-			switchedToBundled: syncResult.summary.switchedToBundled,
-			switchedToNpm: syncResult.summary.switchedToNpm,
-			warnings: syncResult.summary.warnings,
-			errors: syncResult.summary.errors
-		},
-		npm: {
-			changed: npmResult.changed,
-			outcomes: npmResult.outcomes
-		},
-		integrityDrifts
-	};
-}
-async function maybeRestartService(params) {
-	if (params.shouldRestart) {
-		if (!params.opts.json) {
-			defaultRuntime.log("");
-			defaultRuntime.log(theme.heading("Restarting service..."));
-		}
-		try {
-			let restarted = false;
-			let restartInitiated = false;
-			if (params.refreshServiceEnv) try {
-				await refreshGatewayServiceEnv({
-					result: params.result,
-					jsonMode: Boolean(params.opts.json),
-					invocationCwd: params.invocationCwd
-				});
-			} catch (err) {
-				const message = `Failed to refresh gateway service environment from updated install: ${String(err)}`;
-				if (params.opts.json) defaultRuntime.error(message);
-				else defaultRuntime.log(theme.warn(message));
-			}
-			if (params.restartScriptPath) {
-				await runRestartScript(params.restartScriptPath);
-				restartInitiated = true;
-			} else restarted = await runDaemonRestart();
-			if (!params.opts.json && restarted) {
-				defaultRuntime.log(theme.success("Daemon restarted successfully."));
-				defaultRuntime.log("");
-				process.env.GENESIS_UPDATE_IN_PROGRESS = "1";
-				try {
-					await doctorCommand(defaultRuntime, { nonInteractive: !(process.stdin.isTTY && !params.opts.json && params.opts.yes !== true) });
-				} catch (err) {
-					defaultRuntime.log(theme.warn(`Doctor failed: ${String(err)}`));
-				} finally {
-					delete process.env.GENESIS_UPDATE_IN_PROGRESS;
-				}
-			}
-			if (!params.opts.json && restartInitiated) {
-				const service = resolveGatewayService();
-				let health = await waitForGatewayHealthyRestart({
-					service,
-					port: params.gatewayPort
-				});
-				if (!health.healthy && health.staleGatewayPids.length > 0) {
-					if (!params.opts.json) defaultRuntime.log(theme.warn(`Found stale gateway process(es) after restart: ${health.staleGatewayPids.join(", ")}. Cleaning up...`));
-					await terminateStaleGatewayPids(health.staleGatewayPids);
-					await runDaemonRestart();
-					health = await waitForGatewayHealthyRestart({
-						service,
-						port: params.gatewayPort
-					});
-				}
-				if (health.healthy) defaultRuntime.log(theme.success("Daemon restart completed."));
-				else {
-					defaultRuntime.log(theme.warn("Gateway did not become healthy after restart."));
-					for (const line of renderRestartDiagnostics(health)) defaultRuntime.log(theme.muted(line));
-					defaultRuntime.log(theme.muted(`Restart log: ${resolveGatewayRestartLogPath(process.env)}`));
-					defaultRuntime.log(theme.muted(`Run \`${replaceCliName(formatCliCommand("genesis gateway status --deep"), CLI_NAME)}\` for details.`));
-				}
-				defaultRuntime.log("");
-			}
-		} catch (err) {
-			if (!params.opts.json) {
-				defaultRuntime.log(theme.warn(`Daemon restart failed: ${String(err)}`));
-				defaultRuntime.log(theme.muted(`You may need to restart the service manually: ${replaceCliName(formatCliCommand("genesis gateway restart"), CLI_NAME)}`));
-			}
-		}
-		return;
-	}
-	if (!params.opts.json) {
-		defaultRuntime.log("");
-		if (params.result.mode === "npm" || params.result.mode === "pnpm") defaultRuntime.log(theme.muted(`Tip: Run \`${replaceCliName(formatCliCommand("genesis doctor"), CLI_NAME)}\`, then \`${replaceCliName(formatCliCommand("genesis gateway restart"), CLI_NAME)}\` to apply updates to a running gateway.`));
-		else defaultRuntime.log(theme.muted(`Tip: Run \`${replaceCliName(formatCliCommand("genesis gateway restart"), CLI_NAME)}\` to apply updates to a running gateway.`));
-	}
-}
-async function runPostCorePluginUpdate(params) {
-	return await updatePluginsAfterCoreUpdate({
-		root: params.root,
-		channel: params.channel,
-		configSnapshot: params.configSnapshot,
-		opts: params.opts
-	});
-}
-async function writePostCorePluginUpdateResultFile(filePath, result) {
-	if (!filePath) return;
-	await fs.writeFile(filePath, `${JSON.stringify(result)}\n`, "utf-8");
-}
-async function readPostCorePluginUpdateResultFile(filePath) {
-	try {
-		const raw = await fs.readFile(filePath, "utf-8");
-		const parsed = JSON.parse(raw);
-		if (parsed && typeof parsed === "object" && (parsed.status === "ok" || parsed.status === "skipped" || parsed.status === "error")) return parsed;
-	} catch {
-		return;
-	}
-}
-async function continuePostCoreUpdateInFreshProcess(params) {
-	const entryPath = path.join(params.root, "dist", "entry.js");
-	if (!await pathExists(entryPath)) return { resumed: false };
-	const argv = [entryPath, "update"];
-	if (params.opts.json) argv.push("--json");
-	if (params.opts.restart === false) argv.push("--no-restart");
-	if (params.opts.yes) argv.push("--yes");
-	const resultDir = params.opts.json === true ? await fs.mkdtemp(path.join(os.tmpdir(), "genesis-update-post-core-")) : null;
-	const resultPath = resultDir ? path.join(resultDir, "plugins.json") : null;
-	try {
-		const child = spawn(resolveNodeRunner(), argv, {
-			stdio: "inherit",
-			env: {
-				...process.env,
-				[POST_CORE_UPDATE_ENV]: "1",
-				[POST_CORE_UPDATE_CHANNEL_ENV]: params.channel,
-				...resultPath ? { [POST_CORE_UPDATE_RESULT_PATH_ENV]: resultPath } : {}
-			}
-		});
-		const exitCode = await new Promise((resolve, reject) => {
-			child.once("error", reject);
-			child.once("exit", (code, signal) => {
-				if (signal) {
-					reject(/* @__PURE__ */ new Error(`post-update process terminated by signal ${signal}`));
-					return;
-				}
-				resolve(code ?? 1);
-			});
-		});
-		if (exitCode !== 0) {
-			defaultRuntime.exit(exitCode);
-			throw new Error(`post-update process exited with code ${exitCode}`);
-		}
-		const pluginUpdate = resultPath ? await readPostCorePluginUpdateResultFile(resultPath) : void 0;
-		return {
-			resumed: true,
-			...pluginUpdate ? { pluginUpdate } : {}
-		};
-	} finally {
-		if (resultDir) await fs.rm(resultDir, {
-			recursive: true,
-			force: true
-		}).catch(() => void 0);
-	}
-}
-function shouldResumePostCoreUpdateInFreshProcess(params) {
-	return isPackageManagerUpdateMode(params.result.mode) && !params.downgradeRisk;
-}
-async function updateCommand(opts) {
-	suppressDeprecations();
-	const invocationCwd = tryResolveInvocationCwd();
-	const postCoreUpdateResume = process.env[POST_CORE_UPDATE_ENV] === "1";
-	const postCoreUpdateChannel = process.env[POST_CORE_UPDATE_CHANNEL_ENV]?.trim();
-	const timeoutMs = parseTimeoutMsOrExit(opts.timeout);
-	const shouldRestart = opts.restart !== false;
-	if (timeoutMs === null) return;
-	const root = await resolveUpdateRoot();
-	if (postCoreUpdateResume) {
-		if (postCoreUpdateChannel !== "stable" && postCoreUpdateChannel !== "beta" && postCoreUpdateChannel !== "dev") {
-			defaultRuntime.error("Missing post-core update channel context.");
-			defaultRuntime.exit(1);
-			return;
-		}
-		const pluginUpdate = await runPostCorePluginUpdate({
-			root,
-			channel: postCoreUpdateChannel,
-			configSnapshot: await readConfigFileSnapshot(),
-			opts
-		});
-		if (opts.json) {
-			await writePostCorePluginUpdateResultFile(process.env[POST_CORE_UPDATE_RESULT_PATH_ENV], pluginUpdate);
-			if (!process.env[POST_CORE_UPDATE_RESULT_PATH_ENV]) {
-				const result = {
-					status: pluginUpdate.status === "error" ? "error" : "ok",
-					mode: "unknown",
-					root,
-					steps: [],
-					durationMs: 0,
-					postUpdate: { plugins: pluginUpdate }
-				};
-				defaultRuntime.writeJson(result);
-			}
-		}
-		return;
-	}
-	const updateStatus = await checkUpdateStatus({
-		root,
-		timeoutMs: timeoutMs ?? 3500,
-		fetchGit: false,
-		includeRegistry: false
-	});
-	const configSnapshot = await readConfigFileSnapshot();
-	const storedChannel = configSnapshot.valid ? normalizeUpdateChannel(configSnapshot.config.update?.channel) : null;
-	const requestedChannel = normalizeUpdateChannel(opts.channel);
-	if (opts.channel && !requestedChannel) {
-		defaultRuntime.error(`--channel must be "stable", "beta", or "dev" (got "${opts.channel}")`);
-		defaultRuntime.exit(1);
-		return;
-	}
-	if (opts.channel && !configSnapshot.valid) {
-		const issues = formatConfigIssueLines(configSnapshot.issues, "-");
-		defaultRuntime.error(["Config is invalid; cannot set update channel.", ...issues].join("\n"));
-		defaultRuntime.exit(1);
-		return;
-	}
-	const installKind = updateStatus.installKind;
-	const switchToGit = requestedChannel === "dev" && installKind !== "git";
-	const switchToPackage = requestedChannel !== null && requestedChannel !== "dev" && installKind === "git";
-	const updateInstallKind = switchToGit ? "git" : switchToPackage ? "package" : installKind;
-	const inferredChannel = resolveEffectiveUpdateChannel({
-		configChannel: storedChannel,
-		installKind: updateInstallKind,
-		git: updateStatus.git ? {
-			tag: updateStatus.git.tag ?? null,
-			branch: updateStatus.git.branch ?? null
-		} : void 0
-	});
-	const channel = requestedChannel ?? inferredChannel.channel;
-	const devTargetRef = channel === "dev" ? process.env.GENESIS_UPDATE_DEV_TARGET_REF?.trim() || void 0 : void 0;
-	const explicitTag = normalizeTag(opts.tag);
-	let tag = explicitTag ?? channelToNpmTag(channel);
-	let currentVersion = null;
-	let targetVersion = null;
-	let downgradeRisk = false;
-	let fallbackToLatest = false;
-	let packageInstallSpec = null;
-	let packageName = DEFAULT_PACKAGE_NAME;
-	let packageAlreadyCurrent = false;
-	if (updateInstallKind !== "git") {
-		packageName = switchToPackage ? DEFAULT_PACKAGE_NAME : await readPackageName(root) ?? "@pixelzx/genesis";
-		currentVersion = switchToPackage ? null : await readPackageVersion(root);
-		if (explicitTag) targetVersion = await resolveTargetVersion(tag, timeoutMs, packageName);
-		else targetVersion = await resolveNpmChannelTag({
-			packageName,
-			channel,
-			timeoutMs
-		}).then((resolved) => {
-			tag = resolved.tag;
-			fallbackToLatest = channel === "beta" && resolved.tag === "latest";
-			return resolved.version;
-		});
-		const cmp = currentVersion && targetVersion ? compareSemverStrings(currentVersion, targetVersion) : null;
-		packageAlreadyCurrent = updateInstallKind === "package" && !switchToPackage && currentVersion != null && targetVersion != null && currentVersion === targetVersion && (requestedChannel === null || requestedChannel === storedChannel);
-		downgradeRisk = canResolveRegistryVersionForPackageTarget(tag) && !fallbackToLatest && currentVersion != null && (targetVersion == null || cmp != null && cmp > 0);
-		packageInstallSpec = resolveGlobalInstallSpec({
-			packageName,
-			tag,
-			env: process.env
-		});
-	}
-	if (opts.dryRun) {
-		let mode = "unknown";
-		if (updateInstallKind === "git") mode = "git";
-		else if (updateInstallKind === "package") mode = await resolveGlobalManager({
-			root,
-			installKind,
-			timeoutMs: timeoutMs ?? 20 * 6e4
-		});
-		const actions = [];
-		if (requestedChannel && requestedChannel !== storedChannel) actions.push(`Persist update.channel=${requestedChannel} in config`);
-		if (switchToGit) actions.push("Switch install mode from package to git checkout (dev channel)");
-		else if (switchToPackage) actions.push(`Switch install mode from git to package manager (${mode})`);
-		else if (updateInstallKind === "git") actions.push(`Run git update flow on channel ${channel} (fetch/rebase/build/doctor)`);
-		else if (packageAlreadyCurrent) actions.push(`Refresh package install with spec ${packageInstallSpec ?? tag}; current version already matches ${targetVersion}`);
-		else actions.push(`Run global package manager update with spec ${packageInstallSpec ?? tag}`);
-		actions.push("Run plugin update sync after core update");
-		actions.push("Refresh shell completion cache (if needed)");
-		actions.push(shouldRestart ? "Restart gateway service and run doctor checks" : "Skip restart (because --no-restart is set)");
-		const notes = [];
-		if (opts.tag && updateInstallKind === "git") notes.push("--tag applies to npm installs only; git updates ignore it.");
-		if (fallbackToLatest) notes.push("Beta channel resolves to latest for this run (fallback).");
-		if (explicitTag && !canResolveRegistryVersionForPackageTarget(tag)) notes.push("Non-registry package specs skip npm version lookup and downgrade previews.");
-		printDryRunPreview({
-			dryRun: true,
-			root,
-			installKind,
-			mode,
-			updateInstallKind,
-			switchToGit,
-			switchToPackage,
-			restart: shouldRestart,
-			requestedChannel,
-			storedChannel,
-			effectiveChannel: channel,
-			tag: packageInstallSpec ?? tag,
-			currentVersion,
-			targetVersion,
-			downgradeRisk,
-			actions,
-			notes
-		}, Boolean(opts.json));
-		return;
-	}
-	if (downgradeRisk && !opts.yes) {
-		if (!process.stdin.isTTY || opts.json) {
-			defaultRuntime.error(["Downgrade confirmation required.", "Downgrading can break configuration. Re-run in a TTY to confirm."].join("\n"));
-			defaultRuntime.exit(1);
-			return;
-		}
-		const targetLabel = targetVersion ?? `${tag} (unknown)`;
-		const ok = await confirm({
-			message: stylePromptMessage(`Downgrading from ${currentVersion} to ${targetLabel} can break configuration. Continue?`),
-			initialValue: false
-		});
-		if (isCancel(ok) || !ok) {
-			if (!opts.json) defaultRuntime.log(theme.muted("Update cancelled."));
-			defaultRuntime.exit(0);
-			return;
-		}
-	}
-	if (updateInstallKind === "git" && opts.tag && !opts.json) defaultRuntime.log(theme.muted("Note: --tag applies to npm installs only; git updates ignore it."));
-	if (updateInstallKind === "package") {
-		const runtimePreflightError = await resolvePackageRuntimePreflightError({
-			packageName,
-			tag,
-			timeoutMs
-		});
-		if (runtimePreflightError) {
-			defaultRuntime.error(runtimePreflightError);
-			defaultRuntime.exit(1);
-			return;
-		}
-	}
-	const showProgress = !opts.json && process.stdout.isTTY;
-	if (!opts.json) {
-		defaultRuntime.log(theme.heading("Updating Genesis..."));
-		defaultRuntime.log("");
-	}
-	const { progress, stop } = createUpdateProgress(showProgress);
-	const startedAt = Date.now();
-	const result = updateInstallKind === "package" ? await runPackageInstallUpdate({
-		root,
-		installKind,
-		tag,
-		timeoutMs: timeoutMs ?? 20 * 6e4,
-		startedAt,
-		progress
-	}) : await runGitUpdate({
-		root,
-		switchToGit,
-		installKind,
-		timeoutMs,
-		startedAt,
-		progress,
-		channel,
-		tag,
-		showProgress,
-		opts,
-		stop,
-		devTargetRef
-	});
-	stop();
-	if (!opts.json || result.status !== "ok") printResult(result, {
-		...opts,
-		hideSteps: showProgress
-	});
-	if (result.status === "error") {
-		defaultRuntime.exit(1);
-		return;
-	}
-	if (result.status === "skipped") {
-		if (result.reason === "dirty") {
-			defaultRuntime.error(theme.error("Update blocked: local files are edited in this checkout."));
-			defaultRuntime.log(theme.warn("Git-based updates need a clean working tree before they can switch commits, fetch, or rebase."));
-			defaultRuntime.log(theme.muted("Commit, stash, or discard the local changes, then rerun `genesis update`."));
-		}
-		if (result.reason === "not-git-install") {
-			defaultRuntime.log(theme.warn(`Skipped: this Genesis install isn't a git checkout, and the package manager couldn't be detected. Update via your package manager, then run \`${replaceCliName(formatCliCommand("genesis doctor"), CLI_NAME)}\` and \`${replaceCliName(formatCliCommand("genesis gateway restart"), CLI_NAME)}\`.`));
-			defaultRuntime.log(theme.muted(`Examples: \`${replaceCliName(`npm i -g ${DEFAULT_PACKAGE_NAME}@latest`, CLI_NAME)}\` or \`${replaceCliName(`pnpm add -g ${DEFAULT_PACKAGE_NAME}@latest`, CLI_NAME)}\``));
-		}
-		defaultRuntime.exit(0);
-		return;
-	}
-	if (switchToGit && result.status === "ok" && result.mode === "git") {
-		if (!opts.json) defaultRuntime.log(theme.muted("Switched from a package install to a git checkout. Skipping remaining post-update work in the old CLI process; rerun follow-up commands from the new git install if needed."));
-		else defaultRuntime.writeJson(result);
-		defaultRuntime.exit(0);
-		return;
-	}
-	let postUpdateConfigSnapshot = configSnapshot;
-	if (requestedChannel && configSnapshot.valid && requestedChannel !== storedChannel) if (switchToGit) {
-		if (!opts.json) defaultRuntime.log(theme.muted(`Skipped persisting update.channel=${requestedChannel} in the pre-update CLI process after switching to a git install.`));
-	} else {
-		const next = {
-			...configSnapshot.sourceConfig,
-			update: {
-				...configSnapshot.sourceConfig.update,
-				channel: requestedChannel
-			}
-		};
-		await replaceConfigFile({
-			nextConfig: next,
-			baseHash: configSnapshot.hash
-		});
-		postUpdateConfigSnapshot = {
-			...configSnapshot,
-			hash: void 0,
-			parsed: next,
-			sourceConfig: asResolvedSourceConfig(next),
-			resolved: asResolvedSourceConfig(next),
-			runtimeConfig: asRuntimeConfig(next),
-			config: asRuntimeConfig(next)
-		};
-		if (!opts.json) defaultRuntime.log(theme.muted(`Update channel set to ${requestedChannel}.`));
-	}
-	const postUpdateRoot = result.root ?? root;
-	let postCorePluginUpdate;
-	let pluginsUpdatedInFreshProcess = false;
-	if (shouldResumePostCoreUpdateInFreshProcess({
-		result,
-		downgradeRisk
-	})) {
-		const freshProcessResult = await continuePostCoreUpdateInFreshProcess({
-			root: postUpdateRoot,
-			channel,
-			opts
-		});
-		pluginsUpdatedInFreshProcess = freshProcessResult.resumed;
-		postCorePluginUpdate = freshProcessResult.pluginUpdate;
-	}
-	const deferOldProcessPostUpdateWork = switchToGit && result.mode === "git";
-	if (deferOldProcessPostUpdateWork) {
-		if (!opts.json) defaultRuntime.log(theme.muted("Skipped plugin update sync in the pre-update CLI process after switching to a git install."));
-	} else if (!pluginsUpdatedInFreshProcess) postCorePluginUpdate = await runPostCorePluginUpdate({
-		root: postUpdateRoot,
-		channel,
-		configSnapshot: postUpdateConfigSnapshot,
-		opts
-	});
-	let restartScriptPath = null;
-	let refreshGatewayServiceEnv = false;
-	const gatewayPort = resolveGatewayPort(postUpdateConfigSnapshot.valid ? postUpdateConfigSnapshot.config : void 0, process.env);
-	if (shouldRestart) try {
-		if (await resolveGatewayService().isLoaded({ env: process.env })) {
-			restartScriptPath = await prepareRestartScript(process.env, gatewayPort);
-			refreshGatewayServiceEnv = true;
-		}
-	} catch {}
-	if (deferOldProcessPostUpdateWork) {
-		if (!opts.json) defaultRuntime.log(theme.muted("Skipped completion/restart follow-ups in the pre-update CLI process after switching to a git install."));
-	} else {
-		await tryWriteCompletionCache(postUpdateRoot, Boolean(opts.json));
-		await tryInstallShellCompletion({
-			jsonMode: Boolean(opts.json),
-			skipPrompt: Boolean(opts.yes)
-		});
-		await maybeRestartService({
-			shouldRestart,
-			result,
-			opts,
-			refreshServiceEnv: refreshGatewayServiceEnv,
-			gatewayPort,
-			restartScriptPath,
-			invocationCwd
-		});
-	}
-	if (!opts.json) defaultRuntime.log(theme.muted(pickUpdateQuip()));
-	else defaultRuntime.writeJson({
-		...result,
-		...postCorePluginUpdate ? { postUpdate: { plugins: postCorePluginUpdate } } : {}
-	});
-}
-//#endregion
-//#region src/cli/update-cli/wizard.ts
-async function updateWizardCommand(opts = {}) {
-	if (!process.stdin.isTTY) {
-		defaultRuntime.error("Update wizard requires a TTY. Use `genesis update --channel <stable|beta|dev>` instead.");
-		defaultRuntime.exit(1);
-		return;
-	}
-	const timeoutMs = parseTimeoutMsOrExit(opts.timeout);
-	if (timeoutMs === null) return;
-	const root = await resolveUpdateRoot();
-	const [updateStatus, configSnapshot] = await Promise.all([checkUpdateStatus({
-		root,
-		timeoutMs: timeoutMs ?? 3500,
-		fetchGit: false,
-		includeRegistry: false
-	}), readConfigFileSnapshot()]);
-	const channelInfo = resolveEffectiveUpdateChannel({
-		configChannel: configSnapshot.valid ? normalizeUpdateChannel(configSnapshot.config.update?.channel) : null,
-		installKind: updateStatus.installKind,
-		git: updateStatus.git ? {
-			tag: updateStatus.git.tag,
-			branch: updateStatus.git.branch
-		} : void 0
-	});
-	const channelLabel = formatUpdateChannelLabel({
-		channel: channelInfo.channel,
-		source: channelInfo.source,
-		gitTag: updateStatus.git?.tag ?? null,
-		gitBranch: updateStatus.git?.branch ?? null
-	});
-	const pickedChannel = await selectStyled({
-		message: "Update channel",
-		options: [
-			{
-				value: "keep",
-				label: `Keep current (${channelInfo.channel})`,
-				hint: channelLabel
-			},
-			{
-				value: "stable",
-				label: "Stable",
-				hint: "Tagged releases (npm latest)"
-			},
-			{
-				value: "beta",
-				label: "Beta",
-				hint: "Prereleases (npm beta)"
-			},
-			{
-				value: "dev",
-				label: "Dev",
-				hint: "Git main"
-			}
-		],
-		initialValue: "keep"
-	});
-	if (isCancel(pickedChannel)) {
-		defaultRuntime.log(theme.muted("Update cancelled."));
-		defaultRuntime.exit(0);
-		return;
-	}
-	const requestedChannel = pickedChannel === "keep" ? null : pickedChannel;
-	if (requestedChannel === "dev" && updateStatus.installKind !== "git") {
-		const gitDir = resolveGitInstallDir();
-		if (!await isGitCheckout(gitDir)) {
-			if (await pathExists(gitDir)) {
-				if (!await isEmptyDir(gitDir)) {
-					defaultRuntime.error(`GENESIS_GIT_DIR points at a non-git directory: ${gitDir}. Set GENESIS_GIT_DIR to an empty folder or an genesis checkout.`);
-					defaultRuntime.exit(1);
-					return;
-				}
-			}
-			const ok = await confirm({
-				message: stylePromptMessage(`Create a git checkout at ${gitDir}? (override via GENESIS_GIT_DIR)`),
-				initialValue: true
-			});
-			if (isCancel(ok) || !ok) {
-				defaultRuntime.log(theme.muted("Update cancelled."));
-				defaultRuntime.exit(0);
-				return;
-			}
-		}
-	}
-	const restart = await confirm({
-		message: stylePromptMessage("Restart the gateway service after update?"),
-		initialValue: true
-	});
-	if (isCancel(restart)) {
-		defaultRuntime.log(theme.muted("Update cancelled."));
-		defaultRuntime.exit(0);
-		return;
-	}
-	try {
-		await updateCommand({
-			channel: requestedChannel ?? void 0,
-			restart,
-			timeout: opts.timeout
-		});
-	} catch (err) {
-		defaultRuntime.error(String(err));
-		defaultRuntime.exit(1);
-	}
-}
-//#endregion
-//#region src/cli/update-cli.ts
-function inheritedUpdateJson(command) {
-	return Boolean(inheritOptionFromParent(command, "json"));
-}
-function inheritedUpdateTimeout(opts, command) {
-	const timeout = opts.timeout;
-	if (timeout) return timeout;
-	return inheritOptionFromParent(command, "timeout");
-}
-function registerUpdateCli(program) {
-	program.enablePositionalOptions();
-	const update = program.command("update").description("Update Genesis and inspect update channel status").option("--json", "Output result as JSON", false).option("--no-restart", "Skip restarting the gateway service after a successful update").option("--dry-run", "Preview update actions without making changes", false).option("--channel <stable|beta|dev>", "Persist update channel (git + npm)").option("--tag <dist-tag|version|spec>", "Override the package target for this update (dist-tag, version, or package spec)").option("--timeout <seconds>", "Timeout for each update step in seconds (default: 1200)").option("--yes", "Skip confirmation prompts (non-interactive)", false).addHelpText("after", () => {
-		const fmtExamples = [
-			["genesis update", "Update a source checkout (git)"],
-			["genesis update --channel beta", "Switch to beta channel (git + npm)"],
-			["genesis update --channel dev", "Switch to dev channel (git + npm)"],
-			["genesis update --tag beta", "One-off update to a dist-tag or version"],
-			["genesis update --tag main", "One-off package install from GitHub main"],
-			["genesis update --dry-run", "Preview actions without changing anything"],
-			["genesis update --no-restart", "Update without restarting the service"],
-			["genesis update --json", "Output result as JSON"],
-			["genesis update --yes", "Non-interactive (accept downgrade prompts)"],
-			["genesis update wizard", "Interactive update wizard"],
-			["genesis --update", "Shorthand for genesis update"]
-		].map(([cmd, desc]) => `  ${theme.command(cmd)} ${theme.muted(`# ${desc}`)}`).join("\n");
-		return `
-${theme.heading("What this does:")}
-  - Git checkouts: fetches, rebases, installs deps, builds, and runs doctor
-  - npm installs: updates via detected package manager
-
-${theme.heading("Switch channels:")}
-  - Use --channel stable|beta|dev to persist the update channel in config
-  - Run genesis update status to see the active channel and source
-  - Use --tag <dist-tag|version|spec> for a one-off package update without persisting
-
-${theme.heading("Non-interactive:")}
-  - Use --yes to accept downgrade prompts
-  - Combine with --channel/--tag/--restart/--json/--timeout as needed
-  - Use --dry-run to preview actions without writing config/installing/restarting
-
-${theme.heading("Examples:")}
-${fmtExamples}
-
-${theme.heading("Notes:")}
-  - Switch channels with --channel stable|beta|dev
-  - For global installs: auto-updates via detected package manager when possible (see docs/install/updating.md)
-  - Downgrades require confirmation (can break configuration)
-  - Skips update if the working directory has uncommitted changes
-
-${theme.muted("Docs:")} ${formatDocsLink("/cli/update", "genesis.pixelzx.com/docs/cli/update")}`;
-	}).action(async (opts) => {
-		try {
-			await updateCommand({
-				json: Boolean(opts.json),
-				restart: Boolean(opts.restart),
-				dryRun: Boolean(opts.dryRun),
-				channel: opts.channel,
-				tag: opts.tag,
-				timeout: opts.timeout,
-				yes: Boolean(opts.yes)
-			});
-		} catch (err) {
-			defaultRuntime.error(String(err));
-			defaultRuntime.exit(1);
-		}
-	});
-	update.command("wizard").description("Interactive update wizard").option("--timeout <seconds>", "Timeout for each update step in seconds (default: 1200)").addHelpText("after", `\n${theme.muted("Docs:")} ${formatDocsLink("/cli/update", "genesis.pixelzx.com/docs/cli/update")}\n`).action(async (opts, command) => {
-		try {
-			await updateWizardCommand({ timeout: inheritedUpdateTimeout(opts, command) });
-		} catch (err) {
-			defaultRuntime.error(String(err));
-			defaultRuntime.exit(1);
-		}
-	});
-	update.command("status").description("Show update channel and version status").option("--json", "Output result as JSON", false).option("--timeout <seconds>", "Timeout for update checks in seconds (default: 3)").addHelpText("after", () => `\n${theme.heading("Examples:")}\n${formatHelpExamples([
-		["genesis update status", "Show channel + version status."],
-		["genesis update status --json", "JSON output."],
-		["genesis update status --timeout 10", "Custom timeout."]
-	])}\n\n${theme.heading("Notes:")}\n${theme.muted("- Shows current update channel (stable/beta/dev) and source")}\n${theme.muted("- Includes git tag/branch/SHA for source checkouts")}\n\n${theme.muted("Docs:")} ${formatDocsLink("/cli/update", "genesis.pixelzx.com/docs/cli/update")}`).action(async (opts, command) => {
-		try {
-			await updateStatusCommand({
-				json: Boolean(opts.json) || inheritedUpdateJson(command),
-				timeout: inheritedUpdateTimeout(opts, command)
-			});
-		} catch (err) {
-			defaultRuntime.error(String(err));
-			defaultRuntime.exit(1);
-		}
-	});
-}
-//#endregion
-export { registerUpdateCli, updateCommand, updateStatusCommand, updateWizardCommand };