@gguf/claw 2026.2.4 → 2026.2.5

package/dist/{update-runner-8XFxQglY.js → update-runner-2i8_mIG5.js}

@@ -1,6 +1,13 @@
-import { t as runCommandWithTimeout } from "./exec-BIMFe4XS.js";
-import { o as trimLogTail } from "./restart-sentinel-DywisDen.js";
-import { r as parseSemver } from "./runtime-guard-DvBpNsbR.js";
+import { r as resolveCliName, t as formatCliCommand } from "./command-format-ayFsmwwz.js";
+import { t as runCommandWithTimeout } from "./exec-B8JKbXKW.js";
+import { t as resolveOpenClawPackageRoot } from "./openclaw-root-9ILYSmJ9.js";
+import { j as VERSION } from "./config-CKLedg5Y.js";
+import { Ln as trimLogTail } from "./loader-_Pj-TZS2.js";
+import { t as note } from "./note-Ci08TSbV.js";
+import { a as resolveCompletionCachePath, i as isCompletionInstalled, o as resolveShellFromEnv, r as installCompletion, s as usesSlowDynamicCompletion, t as completionCacheExists } from "./completion-cli-BbhA_JbG.js";
+import { g as parseSemver } from "./daemon-runtime-BCn_QIHK.js";
+import { i as resolveControlUiDistIndexPathForRoot, r as resolveControlUiDistIndexHealth } from "./health-format-ND2rUbQO.js";
+import { spawnSync } from "node:child_process";
 import path from "node:path";
 import os from "node:os";
 import fs from "node:fs/promises";
@@ -389,6 +396,163 @@ async function checkUpdateStatus(params) {
 	};
 }
 
+//#endregion
+//#region src/commands/doctor-completion.ts
+/** Generate the completion cache by spawning the CLI. */
+async function generateCompletionCache() {
+	const root = await resolveOpenClawPackageRoot({
+		moduleUrl: import.meta.url,
+		argv1: process.argv[1],
+		cwd: process.cwd()
+	});
+	if (!root) return false;
+	const binPath = path.join(root, "openclaw.mjs");
+	return spawnSync(process.execPath, [
+		binPath,
+		"completion",
+		"--write-state"
+	], {
+		cwd: root,
+		env: process.env,
+		encoding: "utf-8"
+	}).status === 0;
+}
+/** Check the status of shell completion for the current shell. */
+async function checkShellCompletionStatus(binName = "openclaw") {
+	const shell = resolveShellFromEnv();
+	return {
+		shell,
+		profileInstalled: await isCompletionInstalled(shell, binName),
+		cacheExists: await completionCacheExists(shell, binName),
+		cachePath: resolveCompletionCachePath(shell, binName),
+		usesSlowPattern: await usesSlowDynamicCompletion(shell, binName)
+	};
+}
+/**
+* Doctor check for shell completion.
+* - If profile uses slow dynamic pattern: upgrade to cached version
+* - If profile has completion but no cache: auto-generate cache and upgrade profile
+* - If no completion at all: prompt to install (with user confirmation)
+*/
+async function doctorShellCompletion(runtime, prompter, options = {}) {
+	const cliName = resolveCliName();
+	const status = await checkShellCompletionStatus(cliName);
+	if (status.usesSlowPattern) {
+		note(`Your ${status.shell} profile uses slow dynamic completion (source <(...)).\nUpgrading to cached completion for faster shell startup...`, "Shell completion");
+		if (!status.cacheExists) {
+			if (!await generateCompletionCache()) {
+				note(`Failed to generate completion cache. Run \`${cliName} completion --write-state\` manually.`, "Shell completion");
+				return;
+			}
+		}
+		await installCompletion(status.shell, true, cliName);
+		note(`Shell completion upgraded. Restart your shell or run: source ~/.${status.shell === "zsh" ? "zshrc" : status.shell === "bash" ? "bashrc" : "config/fish/config.fish"}`, "Shell completion");
+		return;
+	}
+	if (status.profileInstalled && !status.cacheExists) {
+		note(`Shell completion is configured in your ${status.shell} profile but the cache is missing.\nRegenerating cache...`, "Shell completion");
+		if (await generateCompletionCache()) note(`Completion cache regenerated at ${status.cachePath}`, "Shell completion");
+		else note(`Failed to regenerate completion cache. Run \`${cliName} completion --write-state\` manually.`, "Shell completion");
+		return;
+	}
+	if (!status.profileInstalled) {
+		if (options.nonInteractive) return;
+		if (await prompter.confirm({
+			message: `Enable ${status.shell} shell completion for ${cliName}?`,
+			initialValue: true
+		})) {
+			if (!await generateCompletionCache()) {
+				note(`Failed to generate completion cache. Run \`${cliName} completion --write-state\` manually.`, "Shell completion");
+				return;
+			}
+			await installCompletion(status.shell, true, cliName);
+			note(`Shell completion installed. Restart your shell or run: source ~/.${status.shell === "zsh" ? "zshrc" : status.shell === "bash" ? "bashrc" : "config/fish/config.fish"}`, "Shell completion");
+		}
+	}
+}
+/**
+* Ensure completion cache exists. Used during onboarding/update to fix
+* cases where profile has completion but no cache.
+* This is a silent fix - no prompts.
+*/
+async function ensureCompletionCacheExists(binName = "openclaw") {
+	if (await completionCacheExists(resolveShellFromEnv(), binName)) return true;
+	return generateCompletionCache();
+}
+
+//#endregion
+//#region src/commands/status.update.ts
+async function getUpdateCheckResult(params) {
+	return await checkUpdateStatus({
+		root: await resolveOpenClawPackageRoot({
+			moduleUrl: import.meta.url,
+			argv1: process.argv[1],
+			cwd: process.cwd()
+		}),
+		timeoutMs: params.timeoutMs,
+		fetchGit: params.fetchGit,
+		includeRegistry: params.includeRegistry
+	});
+}
+function resolveUpdateAvailability(update) {
+	const latestVersion = update.registry?.latestVersion ?? null;
+	const registryCmp = latestVersion ? compareSemverStrings(VERSION, latestVersion) : null;
+	const hasRegistryUpdate = registryCmp != null && registryCmp < 0;
+	const gitBehind = update.installKind === "git" && typeof update.git?.behind === "number" ? update.git.behind : null;
+	const hasGitUpdate = gitBehind != null && gitBehind > 0;
+	return {
+		available: hasGitUpdate || hasRegistryUpdate,
+		hasGitUpdate,
+		hasRegistryUpdate,
+		latestVersion: hasRegistryUpdate ? latestVersion : null,
+		gitBehind
+	};
+}
+function formatUpdateAvailableHint(update) {
+	const availability = resolveUpdateAvailability(update);
+	if (!availability.available) return null;
+	const details = [];
+	if (availability.hasGitUpdate && availability.gitBehind != null) details.push(`git behind ${availability.gitBehind}`);
+	if (availability.hasRegistryUpdate && availability.latestVersion) details.push(`npm ${availability.latestVersion}`);
+	return `Update available${details.length > 0 ? ` (${details.join(" · ")})` : ""}. Run: ${formatCliCommand("openclaw update")}`;
+}
+function formatUpdateOneLiner(update) {
+	const parts = [];
+	if (update.installKind === "git" && update.git) {
+		const branch = update.git.branch ? `git ${update.git.branch}` : "git";
+		parts.push(branch);
+		if (update.git.upstream) parts.push(`↔ ${update.git.upstream}`);
+		if (update.git.dirty === true) parts.push("dirty");
+		if (update.git.behind != null && update.git.ahead != null) {
+			if (update.git.behind === 0 && update.git.ahead === 0) parts.push("up to date");
+			else if (update.git.behind > 0 && update.git.ahead === 0) parts.push(`behind ${update.git.behind}`);
+			else if (update.git.behind === 0 && update.git.ahead > 0) parts.push(`ahead ${update.git.ahead}`);
+			else if (update.git.behind > 0 && update.git.ahead > 0) parts.push(`diverged (ahead ${update.git.ahead}, behind ${update.git.behind})`);
+		}
+		if (update.git.fetchOk === false) parts.push("fetch failed");
+		if (update.registry?.latestVersion) {
+			const cmp = compareSemverStrings(VERSION, update.registry.latestVersion);
+			if (cmp === 0) parts.push(`npm latest ${update.registry.latestVersion}`);
+			else if (cmp != null && cmp < 0) parts.push(`npm update ${update.registry.latestVersion}`);
+			else parts.push(`npm latest ${update.registry.latestVersion} (local newer)`);
+		} else if (update.registry?.error) parts.push("npm latest unknown");
+	} else {
+		parts.push(update.packageManager !== "unknown" ? update.packageManager : "pkg");
+		if (update.registry?.latestVersion) {
+			const cmp = compareSemverStrings(VERSION, update.registry.latestVersion);
+			if (cmp === 0) parts.push(`npm latest ${update.registry.latestVersion}`);
+			else if (cmp != null && cmp < 0) parts.push(`npm update ${update.registry.latestVersion}`);
+			else parts.push(`npm latest ${update.registry.latestVersion} (local newer)`);
+		} else if (update.registry?.error) parts.push("npm latest unknown");
+	}
+	if (update.deps) {
+		if (update.deps.status === "ok") parts.push("deps ok");
+		if (update.deps.status === "missing") parts.push("deps missing");
+		if (update.deps.status === "stale") parts.push("deps stale");
+	}
+	return `Update: ${parts.join(" · ")}`;
+}
+
 //#endregion
 //#region src/infra/update-global.ts
 const PRIMARY_PACKAGE_NAME = "openclaw";
@@ -976,12 +1140,12 @@ async function runGatewayUpdate(opts = {}) {
 					const depsStep = await runStep(step(`preflight deps install (${shortSha})`, managerInstallArgs(manager), worktreeDir));
 					steps.push(depsStep);
 					if (depsStep.exitCode !== 0) continue;
-					const lintStep = await runStep(step(`preflight lint (${shortSha})`, managerScriptArgs(manager, "lint"), worktreeDir));
-					steps.push(lintStep);
-					if (lintStep.exitCode !== 0) continue;
 					const buildStep = await runStep(step(`preflight build (${shortSha})`, managerScriptArgs(manager, "build"), worktreeDir));
 					steps.push(buildStep);
 					if (buildStep.exitCode !== 0) continue;
+					const lintStep = await runStep(step(`preflight lint (${shortSha})`, managerScriptArgs(manager, "lint"), worktreeDir));
+					steps.push(lintStep);
+					if (lintStep.exitCode !== 0) continue;
 					selectedSha = sha;
 					break;
 				}
@@ -1129,17 +1293,90 @@ async function runGatewayUpdate(opts = {}) {
 		steps.push(buildStep);
 		const uiBuildStep = await runStep(step("ui:build", managerScriptArgs(manager, "ui:build"), gitRoot));
 		steps.push(uiBuildStep);
-		const restoreUiStep = await runStep(step("restore control-ui", [
-			"git",
-			"-C",
-			gitRoot,
-			"checkout",
-			"--",
-			"dist/control-ui/"
-		], gitRoot));
-		steps.push(restoreUiStep);
-		const doctorStep = await runStep(step("openclaw doctor", managerScriptArgs(manager, "openclaw", ["doctor", "--non-interactive"]), gitRoot, { OPENCLAW_UPDATE_IN_PROGRESS: "1" }));
+		const doctorEntry = path.join(gitRoot, "openclaw.mjs");
+		if (!await fs.stat(doctorEntry).then(() => true).catch(() => false)) {
+			steps.push({
+				name: "openclaw doctor entry",
+				command: `verify ${doctorEntry}`,
+				cwd: gitRoot,
+				durationMs: 0,
+				exitCode: 1,
+				stderrTail: `missing ${doctorEntry}`
+			});
+			return {
+				status: "error",
+				mode: "git",
+				root: gitRoot,
+				reason: "doctor-entry-missing",
+				before: {
+					sha: beforeSha,
+					version: beforeVersion
+				},
+				steps,
+				durationMs: Date.now() - startedAt
+			};
+		}
+		const doctorStep = await runStep(step("openclaw doctor", [
+			process.execPath,
+			doctorEntry,
+			"doctor",
+			"--non-interactive"
+		], gitRoot, { OPENCLAW_UPDATE_IN_PROGRESS: "1" }));
 		steps.push(doctorStep);
+		if (!(await resolveControlUiDistIndexHealth({ root: gitRoot })).exists) {
+			const repairArgv = managerScriptArgs(manager, "ui:build");
+			const started = Date.now();
+			const repairResult = await runCommand(repairArgv, {
+				cwd: gitRoot,
+				timeoutMs
+			});
+			const repairStep = {
+				name: "ui:build (post-doctor repair)",
+				command: repairArgv.join(" "),
+				cwd: gitRoot,
+				durationMs: Date.now() - started,
+				exitCode: repairResult.code,
+				stdoutTail: trimLogTail(repairResult.stdout, MAX_LOG_CHARS),
+				stderrTail: trimLogTail(repairResult.stderr, MAX_LOG_CHARS)
+			};
+			steps.push(repairStep);
+			if (repairResult.code !== 0) return {
+				status: "error",
+				mode: "git",
+				root: gitRoot,
+				reason: repairStep.name,
+				before: {
+					sha: beforeSha,
+					version: beforeVersion
+				},
+				steps,
+				durationMs: Date.now() - startedAt
+			};
+			const repairedUiIndexHealth = await resolveControlUiDistIndexHealth({ root: gitRoot });
+			if (!repairedUiIndexHealth.exists) {
+				const uiIndexPath = repairedUiIndexHealth.indexPath ?? resolveControlUiDistIndexPathForRoot(gitRoot);
+				steps.push({
+					name: "ui assets verify",
+					command: `verify ${uiIndexPath}`,
+					cwd: gitRoot,
+					durationMs: 0,
+					exitCode: 1,
+					stderrTail: `missing ${uiIndexPath}`
+				});
+				return {
+					status: "error",
+					mode: "git",
+					root: gitRoot,
+					reason: "ui-assets-missing",
+					before: {
+						sha: beforeSha,
+						version: beforeVersion
+					},
+					steps,
+					durationMs: Date.now() - startedAt
+				};
+			}
+		}
 		const failedStep = steps.find((s) => s.exitCode !== 0);
 		const afterShaStep = await runStep(step("git rev-parse HEAD (after)", [
 			"git",
@@ -1218,4 +1455,4 @@ async function runGatewayUpdate(opts = {}) {
 }
 
 //#endregion
-export { globalInstallArgs as a, compareSemverStrings as c, DEFAULT_GIT_CHANNEL as d, DEFAULT_PACKAGE_CHANNEL as f, resolveEffectiveUpdateChannel as g, normalizeUpdateChannel as h, detectGlobalInstallManagerForRoot as i, fetchNpmTagVersion as l, formatUpdateChannelLabel as m, cleanupGlobalRenameDirs as n, resolveGlobalPackageRoot as o, channelToNpmTag as p, detectGlobalInstallManagerByPresence as r, checkUpdateStatus as s, runGatewayUpdate as t, resolveNpmChannelTag as u };
+export { resolveEffectiveUpdateChannel as C, normalizeUpdateChannel as S, resolveNpmChannelTag as _, globalInstallArgs as a, channelToNpmTag as b, formatUpdateOneLiner as c, checkShellCompletionStatus as d, doctorShellCompletion as f, fetchNpmTagVersion as g, compareSemverStrings as h, detectGlobalInstallManagerForRoot as i, getUpdateCheckResult as l, checkUpdateStatus as m, cleanupGlobalRenameDirs as n, resolveGlobalPackageRoot as o, ensureCompletionCacheExists as p, detectGlobalInstallManagerByPresence as r, formatUpdateAvailableHint as s, runGatewayUpdate as t, resolveUpdateAvailability as u, DEFAULT_GIT_CHANNEL as v, formatUpdateChannelLabel as x, DEFAULT_PACKAGE_CHANNEL as y };

package/dist/{update-runner-s8Rs8ex3.js → update-runner-BDdk_K2S.js}

@@ -1,9 +1,16 @@
-import { t as runCommandWithTimeout } from "./exec-CTo4hK94.js";
-import { o as trimLogTail } from "./restart-sentinel-CdcBcziq.js";
-import { r as parseSemver } from "./runtime-guard-BG6JybtL.js";
+import { q as trimLogTail } from "./reply-B8pOiUNN.js";
+import { t as runCommandWithTimeout } from "./exec-HEWTMJ7j.js";
+import { t as resolveOpenClawPackageRoot } from "./openclaw-root-Cvotktkd.js";
+import { r as resolveCliName, t as formatCliCommand } from "./command-format-ChfKqObn.js";
+import { j as VERSION } from "./config-CAuZ-EkU.js";
+import { _ as parseSemver } from "./daemon-runtime-DMd0mgTK.js";
+import { t as note } from "./note-B5HnoeZX.js";
+import { i as resolveControlUiDistIndexPathForRoot, r as resolveControlUiDistIndexHealth } from "./health-format-B3eStY5r.js";
+import { a as resolveCompletionCachePath, i as isCompletionInstalled, o as resolveShellFromEnv, r as installCompletion, s as usesSlowDynamicCompletion, t as completionCacheExists } from "./completion-cli-BPIeQDFy.js";
 import os from "node:os";
 import path from "node:path";
 import fs from "node:fs/promises";
+import { spawnSync } from "node:child_process";
 
 //#region src/infra/update-channels.ts
 const DEFAULT_PACKAGE_CHANNEL = "stable";
@@ -389,6 +396,163 @@ async function checkUpdateStatus(params) {
 	};
 }
 
+//#endregion
+//#region src/commands/status.update.ts
+async function getUpdateCheckResult(params) {
+	return await checkUpdateStatus({
+		root: await resolveOpenClawPackageRoot({
+			moduleUrl: import.meta.url,
+			argv1: process.argv[1],
+			cwd: process.cwd()
+		}),
+		timeoutMs: params.timeoutMs,
+		fetchGit: params.fetchGit,
+		includeRegistry: params.includeRegistry
+	});
+}
+function resolveUpdateAvailability(update) {
+	const latestVersion = update.registry?.latestVersion ?? null;
+	const registryCmp = latestVersion ? compareSemverStrings(VERSION, latestVersion) : null;
+	const hasRegistryUpdate = registryCmp != null && registryCmp < 0;
+	const gitBehind = update.installKind === "git" && typeof update.git?.behind === "number" ? update.git.behind : null;
+	const hasGitUpdate = gitBehind != null && gitBehind > 0;
+	return {
+		available: hasGitUpdate || hasRegistryUpdate,
+		hasGitUpdate,
+		hasRegistryUpdate,
+		latestVersion: hasRegistryUpdate ? latestVersion : null,
+		gitBehind
+	};
+}
+function formatUpdateAvailableHint(update) {
+	const availability = resolveUpdateAvailability(update);
+	if (!availability.available) return null;
+	const details = [];
+	if (availability.hasGitUpdate && availability.gitBehind != null) details.push(`git behind ${availability.gitBehind}`);
+	if (availability.hasRegistryUpdate && availability.latestVersion) details.push(`npm ${availability.latestVersion}`);
+	return `Update available${details.length > 0 ? ` (${details.join(" · ")})` : ""}. Run: ${formatCliCommand("openclaw update")}`;
+}
+function formatUpdateOneLiner(update) {
+	const parts = [];
+	if (update.installKind === "git" && update.git) {
+		const branch = update.git.branch ? `git ${update.git.branch}` : "git";
+		parts.push(branch);
+		if (update.git.upstream) parts.push(`↔ ${update.git.upstream}`);
+		if (update.git.dirty === true) parts.push("dirty");
+		if (update.git.behind != null && update.git.ahead != null) {
+			if (update.git.behind === 0 && update.git.ahead === 0) parts.push("up to date");
+			else if (update.git.behind > 0 && update.git.ahead === 0) parts.push(`behind ${update.git.behind}`);
+			else if (update.git.behind === 0 && update.git.ahead > 0) parts.push(`ahead ${update.git.ahead}`);
+			else if (update.git.behind > 0 && update.git.ahead > 0) parts.push(`diverged (ahead ${update.git.ahead}, behind ${update.git.behind})`);
+		}
+		if (update.git.fetchOk === false) parts.push("fetch failed");
+		if (update.registry?.latestVersion) {
+			const cmp = compareSemverStrings(VERSION, update.registry.latestVersion);
+			if (cmp === 0) parts.push(`npm latest ${update.registry.latestVersion}`);
+			else if (cmp != null && cmp < 0) parts.push(`npm update ${update.registry.latestVersion}`);
+			else parts.push(`npm latest ${update.registry.latestVersion} (local newer)`);
+		} else if (update.registry?.error) parts.push("npm latest unknown");
+	} else {
+		parts.push(update.packageManager !== "unknown" ? update.packageManager : "pkg");
+		if (update.registry?.latestVersion) {
+			const cmp = compareSemverStrings(VERSION, update.registry.latestVersion);
+			if (cmp === 0) parts.push(`npm latest ${update.registry.latestVersion}`);
+			else if (cmp != null && cmp < 0) parts.push(`npm update ${update.registry.latestVersion}`);
+			else parts.push(`npm latest ${update.registry.latestVersion} (local newer)`);
+		} else if (update.registry?.error) parts.push("npm latest unknown");
+	}
+	if (update.deps) {
+		if (update.deps.status === "ok") parts.push("deps ok");
+		if (update.deps.status === "missing") parts.push("deps missing");
+		if (update.deps.status === "stale") parts.push("deps stale");
+	}
+	return `Update: ${parts.join(" · ")}`;
+}
+
+//#endregion
+//#region src/commands/doctor-completion.ts
+/** Generate the completion cache by spawning the CLI. */
+async function generateCompletionCache() {
+	const root = await resolveOpenClawPackageRoot({
+		moduleUrl: import.meta.url,
+		argv1: process.argv[1],
+		cwd: process.cwd()
+	});
+	if (!root) return false;
+	const binPath = path.join(root, "openclaw.mjs");
+	return spawnSync(process.execPath, [
+		binPath,
+		"completion",
+		"--write-state"
+	], {
+		cwd: root,
+		env: process.env,
+		encoding: "utf-8"
+	}).status === 0;
+}
+/** Check the status of shell completion for the current shell. */
+async function checkShellCompletionStatus(binName = "openclaw") {
+	const shell = resolveShellFromEnv();
+	return {
+		shell,
+		profileInstalled: await isCompletionInstalled(shell, binName),
+		cacheExists: await completionCacheExists(shell, binName),
+		cachePath: resolveCompletionCachePath(shell, binName),
+		usesSlowPattern: await usesSlowDynamicCompletion(shell, binName)
+	};
+}
+/**
+* Doctor check for shell completion.
+* - If profile uses slow dynamic pattern: upgrade to cached version
+* - If profile has completion but no cache: auto-generate cache and upgrade profile
+* - If no completion at all: prompt to install (with user confirmation)
+*/
+async function doctorShellCompletion(runtime, prompter, options = {}) {
+	const cliName = resolveCliName();
+	const status = await checkShellCompletionStatus(cliName);
+	if (status.usesSlowPattern) {
+		note(`Your ${status.shell} profile uses slow dynamic completion (source <(...)).\nUpgrading to cached completion for faster shell startup...`, "Shell completion");
+		if (!status.cacheExists) {
+			if (!await generateCompletionCache()) {
+				note(`Failed to generate completion cache. Run \`${cliName} completion --write-state\` manually.`, "Shell completion");
+				return;
+			}
+		}
+		await installCompletion(status.shell, true, cliName);
+		note(`Shell completion upgraded. Restart your shell or run: source ~/.${status.shell === "zsh" ? "zshrc" : status.shell === "bash" ? "bashrc" : "config/fish/config.fish"}`, "Shell completion");
+		return;
+	}
+	if (status.profileInstalled && !status.cacheExists) {
+		note(`Shell completion is configured in your ${status.shell} profile but the cache is missing.\nRegenerating cache...`, "Shell completion");
+		if (await generateCompletionCache()) note(`Completion cache regenerated at ${status.cachePath}`, "Shell completion");
+		else note(`Failed to regenerate completion cache. Run \`${cliName} completion --write-state\` manually.`, "Shell completion");
+		return;
+	}
+	if (!status.profileInstalled) {
+		if (options.nonInteractive) return;
+		if (await prompter.confirm({
+			message: `Enable ${status.shell} shell completion for ${cliName}?`,
+			initialValue: true
+		})) {
+			if (!await generateCompletionCache()) {
+				note(`Failed to generate completion cache. Run \`${cliName} completion --write-state\` manually.`, "Shell completion");
+				return;
+			}
+			await installCompletion(status.shell, true, cliName);
+			note(`Shell completion installed. Restart your shell or run: source ~/.${status.shell === "zsh" ? "zshrc" : status.shell === "bash" ? "bashrc" : "config/fish/config.fish"}`, "Shell completion");
+		}
+	}
+}
+/**
+* Ensure completion cache exists. Used during onboarding/update to fix
+* cases where profile has completion but no cache.
+* This is a silent fix - no prompts.
+*/
+async function ensureCompletionCacheExists(binName = "openclaw") {
+	if (await completionCacheExists(resolveShellFromEnv(), binName)) return true;
+	return generateCompletionCache();
+}
+
 //#endregion
 //#region src/infra/update-global.ts
 const PRIMARY_PACKAGE_NAME = "openclaw";
@@ -976,12 +1140,12 @@ async function runGatewayUpdate(opts = {}) {
 					const depsStep = await runStep(step(`preflight deps install (${shortSha})`, managerInstallArgs(manager), worktreeDir));
 					steps.push(depsStep);
 					if (depsStep.exitCode !== 0) continue;
-					const lintStep = await runStep(step(`preflight lint (${shortSha})`, managerScriptArgs(manager, "lint"), worktreeDir));
-					steps.push(lintStep);
-					if (lintStep.exitCode !== 0) continue;
 					const buildStep = await runStep(step(`preflight build (${shortSha})`, managerScriptArgs(manager, "build"), worktreeDir));
 					steps.push(buildStep);
 					if (buildStep.exitCode !== 0) continue;
+					const lintStep = await runStep(step(`preflight lint (${shortSha})`, managerScriptArgs(manager, "lint"), worktreeDir));
+					steps.push(lintStep);
+					if (lintStep.exitCode !== 0) continue;
 					selectedSha = sha;
 					break;
 				}
@@ -1129,17 +1293,90 @@ async function runGatewayUpdate(opts = {}) {
 		steps.push(buildStep);
 		const uiBuildStep = await runStep(step("ui:build", managerScriptArgs(manager, "ui:build"), gitRoot));
 		steps.push(uiBuildStep);
-		const restoreUiStep = await runStep(step("restore control-ui", [
-			"git",
-			"-C",
-			gitRoot,
-			"checkout",
-			"--",
-			"dist/control-ui/"
-		], gitRoot));
-		steps.push(restoreUiStep);
-		const doctorStep = await runStep(step("openclaw doctor", managerScriptArgs(manager, "openclaw", ["doctor", "--non-interactive"]), gitRoot, { OPENCLAW_UPDATE_IN_PROGRESS: "1" }));
+		const doctorEntry = path.join(gitRoot, "openclaw.mjs");
+		if (!await fs.stat(doctorEntry).then(() => true).catch(() => false)) {
+			steps.push({
+				name: "openclaw doctor entry",
+				command: `verify ${doctorEntry}`,
+				cwd: gitRoot,
+				durationMs: 0,
+				exitCode: 1,
+				stderrTail: `missing ${doctorEntry}`
+			});
+			return {
+				status: "error",
+				mode: "git",
+				root: gitRoot,
+				reason: "doctor-entry-missing",
+				before: {
+					sha: beforeSha,
+					version: beforeVersion
+				},
+				steps,
+				durationMs: Date.now() - startedAt
+			};
+		}
+		const doctorStep = await runStep(step("openclaw doctor", [
+			process.execPath,
+			doctorEntry,
+			"doctor",
+			"--non-interactive"
+		], gitRoot, { OPENCLAW_UPDATE_IN_PROGRESS: "1" }));
 		steps.push(doctorStep);
+		if (!(await resolveControlUiDistIndexHealth({ root: gitRoot })).exists) {
+			const repairArgv = managerScriptArgs(manager, "ui:build");
+			const started = Date.now();
+			const repairResult = await runCommand(repairArgv, {
+				cwd: gitRoot,
+				timeoutMs
+			});
+			const repairStep = {
+				name: "ui:build (post-doctor repair)",
+				command: repairArgv.join(" "),
+				cwd: gitRoot,
+				durationMs: Date.now() - started,
+				exitCode: repairResult.code,
+				stdoutTail: trimLogTail(repairResult.stdout, MAX_LOG_CHARS),
+				stderrTail: trimLogTail(repairResult.stderr, MAX_LOG_CHARS)
+			};
+			steps.push(repairStep);
+			if (repairResult.code !== 0) return {
+				status: "error",
+				mode: "git",
+				root: gitRoot,
+				reason: repairStep.name,
+				before: {
+					sha: beforeSha,
+					version: beforeVersion
+				},
+				steps,
+				durationMs: Date.now() - startedAt
+			};
+			const repairedUiIndexHealth = await resolveControlUiDistIndexHealth({ root: gitRoot });
+			if (!repairedUiIndexHealth.exists) {
+				const uiIndexPath = repairedUiIndexHealth.indexPath ?? resolveControlUiDistIndexPathForRoot(gitRoot);
+				steps.push({
+					name: "ui assets verify",
+					command: `verify ${uiIndexPath}`,
+					cwd: gitRoot,
+					durationMs: 0,
+					exitCode: 1,
+					stderrTail: `missing ${uiIndexPath}`
+				});
+				return {
+					status: "error",
+					mode: "git",
+					root: gitRoot,
+					reason: "ui-assets-missing",
+					before: {
+						sha: beforeSha,
+						version: beforeVersion
+					},
+					steps,
+					durationMs: Date.now() - startedAt
+				};
+			}
+		}
 		const failedStep = steps.find((s) => s.exitCode !== 0);
 		const afterShaStep = await runStep(step("git rev-parse HEAD (after)", [
 			"git",
@@ -1218,4 +1455,4 @@ async function runGatewayUpdate(opts = {}) {
 }
 
 //#endregion
-export { globalInstallArgs as a, compareSemverStrings as c, DEFAULT_GIT_CHANNEL as d, DEFAULT_PACKAGE_CHANNEL as f, resolveEffectiveUpdateChannel as g, normalizeUpdateChannel as h, detectGlobalInstallManagerForRoot as i, fetchNpmTagVersion as l, formatUpdateChannelLabel as m, cleanupGlobalRenameDirs as n, resolveGlobalPackageRoot as o, channelToNpmTag as p, detectGlobalInstallManagerByPresence as r, checkUpdateStatus as s, runGatewayUpdate as t, resolveNpmChannelTag as u };
+export { resolveEffectiveUpdateChannel as C, normalizeUpdateChannel as S, resolveNpmChannelTag as _, globalInstallArgs as a, channelToNpmTag as b, doctorShellCompletion as c, formatUpdateOneLiner as d, getUpdateCheckResult as f, fetchNpmTagVersion as g, compareSemverStrings as h, detectGlobalInstallManagerForRoot as i, ensureCompletionCacheExists as l, checkUpdateStatus as m, cleanupGlobalRenameDirs as n, resolveGlobalPackageRoot as o, resolveUpdateAvailability as p, detectGlobalInstallManagerByPresence as r, checkShellCompletionStatus as s, runGatewayUpdate as t, formatUpdateAvailableHint as u, DEFAULT_GIT_CHANNEL as v, formatUpdateChannelLabel as x, DEFAULT_PACKAGE_CHANNEL as y };

package/dist/usage-format-DvowRSs-.js

@@ -0,0 +1,36 @@
+//#region src/utils/usage-format.ts
+function formatTokenCount(value) {
+	if (value === void 0 || !Number.isFinite(value)) return "0";
+	const safe = Math.max(0, value);
+	if (safe >= 1e6) return `${(safe / 1e6).toFixed(1)}m`;
+	if (safe >= 1e3) return `${(safe / 1e3).toFixed(safe >= 1e4 ? 0 : 1)}k`;
+	return String(Math.round(safe));
+}
+function formatUsd(value) {
+	if (value === void 0 || !Number.isFinite(value)) return;
+	if (value >= 1) return `$${value.toFixed(2)}`;
+	if (value >= .01) return `$${value.toFixed(2)}`;
+	return `$${value.toFixed(4)}`;
+}
+function resolveModelCostConfig(params) {
+	const provider = params.provider?.trim();
+	const model = params.model?.trim();
+	if (!provider || !model) return;
+	return ((params.config?.models?.providers ?? {})[provider]?.models?.find((item) => item.id === model))?.cost;
+}
+const toNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : 0;
+function estimateUsageCost(params) {
+	const usage = params.usage;
+	const cost = params.cost;
+	if (!usage || !cost) return;
+	const input = toNumber(usage.input);
+	const output = toNumber(usage.output);
+	const cacheRead = toNumber(usage.cacheRead);
+	const cacheWrite = toNumber(usage.cacheWrite);
+	const total = input * cost.input + output * cost.output + cacheRead * cost.cacheRead + cacheWrite * cost.cacheWrite;
+	if (!Number.isFinite(total)) return;
+	return total / 1e6;
+}
+
+//#endregion
+export { resolveModelCostConfig as i, formatTokenCount as n, formatUsd as r, estimateUsageCost as t };