@dsh-workbench/core 1.1.11 → 1.1.13

package/dist/client/index.js

@@ -3577,6 +3577,7 @@ var en = {
 	"env.stepFailed.install": "install failed",
 	"env.stepFailed.path": "installed but not found",
 	"env.stepFailed.shell": "cannot reach the command line",
+	"env.stepFailed.host": "the command never returned",
 	"env.toolchain.ok": "Looks good",
 	"env.toolchain.warn": "Almost ready",
 	"env.runtime.ok": "Ready",
@@ -3589,9 +3590,11 @@ var en = {
 	"env.fix.why": "The workbench uses its own background tool (installed separately from the one in your terminal), and it is not set up on this machine yet.",
 	"env.fix.whyPath": "The background tool is installed, but this environment cannot find it — usually a PATH or shell-session issue.",
 	"env.fix.whyShell": "The workbench cannot reach the command line on this machine, so it cannot fetch data — you cannot install this from here; someone needs to fix the background environment.",
+	"env.fix.whyHost": "The workbench runs a few checks on the command line and collects what they return; this time the command went out and nothing came back. The tools themselves are most likely fine — reinstalling Node / npm / pnpm will not help.",
 	"env.fix.step": "Run this in a terminal, then hit Retry:",
 	"env.fix.stepPath": "Open a new terminal window (or make sure npm’s global bin directory is on PATH), then hit Retry.",
 	"env.fix.stepShell": "Restart the workbench (or dsh); if it keeps happening, the workbench still cannot reach the command line.",
+	"env.fix.stepHost": "Quit the workbench completely (including the tray icon), clear the dsh-* leftovers in the system temp folder, then open it again. If it keeps happening, update dsh.",
 	"env.fix.permission": "Permission denied: rerun with sudo, or point npm’s global directory at your home.",
 	"env.fix.network": "Network unreachable: check your network or proxy, then retry.",
 	"env.fix.details": "Details (for troubleshooting)",
@@ -4343,6 +4346,7 @@ var dictionaries = {
 		"env.stepFailed.install": "装不上",
 		"env.stepFailed.path": "装了但还找不到",
 		"env.stepFailed.shell": "连不上命令行",
+		"env.stepFailed.host": "命令行没有返回",
 		"env.toolchain.ok": "正常",
 		"env.toolchain.warn": "还没完全准备好",
 		"env.runtime.ok": "已就绪",
@@ -4355,9 +4359,11 @@ var dictionaries = {
 		"env.fix.why": "工作台用它自己那份后台工具（与你在终端里那套分开装，互不影响），这台机器上还没装好它。",
 		"env.fix.whyPath": "后台工具装上了，但当前环境还找不到它 —— 通常是 PATH 或终端会话的问题。",
 		"env.fix.whyShell": "工作台拿不到这台机器的命令行，所以取不了数据 —— 这一步你装不了，需要有人处理后台环境。",
+		"env.fix.whyHost": "工作台要靠命令行跑几条检查，再把结果收回来；这次命令发出去了，结果一直没回来。工具本身多半是好的 —— 重装 Node / npm / pnpm 不会有帮助。",
 		"env.fix.step": "在终端里运行下面这条命令，装好之后点「重试」：",
 		"env.fix.stepPath": "新开一个终端窗口（或确认 npm 的全局 bin 目录在 PATH 里），然后点「重试」。",
 		"env.fix.stepShell": "重启一次工作台（或 dsh）；如果反复出现，说明工作台还是拿不到命令行。",
+		"env.fix.stepHost": "完全退出工作台（托盘图标也要退），清掉系统临时目录里 dsh- 开头的残留，再重新打开；反复出现就升级 dsh。",
 		"env.fix.permission": "权限不够：在命令前加 sudo 重跑，或先把 npm 的全局目录配到你的用户目录。",
 		"env.fix.network": "网络不通：检查网络或代理设置后重试。",
 		"env.fix.details": "详细输出（排障用）",
@@ -10386,11 +10392,17 @@ function readBundleInspection(spec, registry) {
 		...registry === void 0 || registry === "" ? {} : { registry }
 	});
 }
-function readModuleVersions(force = false) {
-	return apiGet(MODULE_VERSIONS_ROUTE, force ? { force: "1" } : void 0);
+function readModuleVersions(force = false, check = true) {
+	return apiGet(MODULE_VERSIONS_ROUTE, {
+		...force ? { force: "1" } : {},
+		...check ? {} : { check: "0" }
+	});
 }
-function readInstalledPlugins(force = false) {
-	return apiGet(INSTALLED_PLUGINS_ROUTE, force ? { force: "1" } : void 0);
+function readInstalledPlugins(force = false, check = true) {
+	return apiGet(INSTALLED_PLUGINS_ROUTE, {
+		...force ? { force: "1" } : {},
+		...check ? {} : { check: "0" }
+	});
 }
 //#endregion
 //#region src/app/layouts/market/use-module-versions.ts
@@ -10419,6 +10431,10 @@ var newestForceSeq = {
 	modules: -1,
 	plugins: -1
 };
+var newestDataSeq = {
+	modules: -1,
+	plugins: -1
+};
 var epoch = 0;
 var allSeq = 0;
 function bumpModuleVersionsEpoch() {
@@ -10445,9 +10461,39 @@ function withMarketUpdates(modules, rows) {
 		};
 	});
 }
-function moduleVersionsCheckedAt(now) {
-	const at = [now.modulesCheck.checkedAt, now.pluginsCheck.checkedAt].filter((one) => one !== null);
-	return at.length === 0 ? null : Math.max(...at);
+function withPreviousLatest(modules, previous) {
+	if (previous.length === 0) return modules;
+	const byPkg = new Map(previous.map((module) => [module.pkg, module]));
+	return modules.map((module) => {
+		const old = byPkg.get(module.pkg);
+		if (old === void 0) return module;
+		return {
+			...module,
+			...module.latest === void 0 && old.latest !== void 0 ? { latest: old.latest } : {},
+			...module.latestBlocked === void 0 && old.latestBlocked !== void 0 ? { latestBlocked: old.latestBlocked } : {},
+			...module.latestUnavailable === void 0 && old.latestUnavailable !== void 0 ? { latestUnavailable: old.latestUnavailable } : {}
+		};
+	});
+}
+function withPreviousPluginLatest(plugins, previous) {
+	if (previous.length === 0) return plugins;
+	const byPkg = new Map(previous.map((plugin) => [plugin.pkg, plugin]));
+	return plugins.map((plugin) => {
+		const old = byPkg.get(plugin.pkg);
+		if (old === void 0 || plugin.latest !== void 0 || old.latest === void 0) return plugin;
+		return {
+			...plugin,
+			latest: old.latest
+		};
+	});
+}
+function withPreviousWorkbenchLatest(next, previous) {
+	if (next === null || previous === null) return next;
+	if (next.latest !== void 0 || previous.latest === void 0 || next.pkg !== previous.pkg) return next;
+	return {
+		...next,
+		latest: previous.latest
+	};
 }
 function moduleVersionsChecking(value) {
 	return value.allChecking || value.modulesCheck.checking || value.pluginsCheck.checking;
@@ -10478,72 +10524,104 @@ function landed(seat, ticket, latest, ok, at) {
 		checkedAt: ok ? at : seat.checkedAt
 	};
 }
-function readModulesOnce(force) {
-	return Promise.all([readModuleVersions(force), readMarketInstalled()]).catch(() => null);
+function readModulesOnce(force, check) {
+	return Promise.all([readModuleVersions(force, check), readMarketInstalled()]).catch(() => null);
 }
-function readPluginsOnce(force) {
-	return readInstalledPlugins(force).catch(() => null);
+function readPluginsOnce(force, check) {
+	return readInstalledPlugins(force, check).catch(() => null);
 }
-function runModuleVersionsRead(force = false, fresh = false, scope = "all") {
+function readKey(run) {
+	return `${run.kind}:${run.scope}:${run.force ? "force" : "cached"}`;
+}
+function superseded(run, part, ticket) {
+	if (run.kind === "data") return ticket < newestDataSeq[part];
+	return !run.force && ticket < newestForceSeq[part];
+}
+function runRead(run) {
 	const at = epoch;
-	const running = inFlight.get(scope);
-	if (!fresh && running !== void 0 && running.force === force && running.epoch === at) return running.promise;
-	const allTicket = scope === "all" ? allSeq += 1 : allSeq;
+	const key = readKey(run);
+	const running = inFlight.get(key);
+	if (!run.fresh && running !== void 0 && running.epoch === at) return running.promise;
+	const check = run.kind === "check";
+	const allTicket = run.scope === "all" ? allSeq += 1 : allSeq;
 	const tickets = /* @__PURE__ */ new Map();
-	for (const part of partsOf(scope)) {
+	for (const part of partsOf(run.scope)) {
 		const ticket = seq$1[part] += 1;
 		tickets.set(part, ticket);
-		if (force) newestForceSeq[part] = ticket;
+		if (run.force) newestForceSeq[part] = ticket;
+		if (!check) newestDataSeq[part] = ticket;
 	}
-	publish$1(checking(scope));
-	const modulesRead = tickets.has("modules") ? readModulesOnce(force) : null;
-	const pluginsRead = tickets.has("plugins") ? readPluginsOnce(force) : null;
-	const promise = Promise.all([modulesRead, pluginsRead]).then(([modules, plugins]) => {
-		if (at !== epoch) return;
-		const now = Date.now();
-		const modulesTicket = tickets.get("modules");
-		const pluginsTicket = tickets.get("plugins");
-		const modulesLanded = modulesTicket !== void 0 && (force || modulesTicket >= newestForceSeq.modules);
-		const pluginsLanded = pluginsTicket !== void 0 && (force || pluginsTicket >= newestForceSeq.plugins);
-		const modulesOk = modulesLanded && modules !== null && modules[0].ok === true;
-		const pluginsOk = pluginsLanded && plugins !== null && plugins.ok === true;
+	if (check) publish$1(checking(run.scope));
+	const modulesTicket = tickets.get("modules");
+	const pluginsTicket = tickets.get("plugins");
+	const modulesRead = modulesTicket === void 0 ? null : readModulesOnce(run.force, check).then((response) => {
+		if (at !== epoch || response === null || superseded(run, "modules", modulesTicket)) return;
+		const [modules, market] = response;
+		const payload = modules.ok === true ? modules : null;
+		const listed = payload === null ? null : withMarketUpdates(payload.modules, market.ok === true ? market.modules : []);
+		const shown = listed === null ? null : check ? listed : withPreviousLatest(listed, state.modules ?? []);
 		publish$1({
 			...state,
-			modules: modulesOk ? withMarketUpdates(modules[0].modules, modules[1].ok === true ? modules[1].modules : []) : state.modules,
-			workbench: modulesOk ? modules[0].workbench ?? null : state.workbench,
-			selfUpdate: modulesOk ? modules[0].selfUpdate ?? null : state.selfUpdate,
-			plugins: pluginsOk ? plugins.plugins : state.plugins,
+			modules: shown ?? state.modules,
+			workbench: payload === null ? state.workbench : check ? payload.workbench ?? null : withPreviousWorkbenchLatest(payload.workbench ?? null, state.workbench),
+			selfUpdate: payload === null ? state.selfUpdate : payload.selfUpdate ?? null,
 			read: true,
-			allChecking: scope === "all" && allTicket === allSeq ? false : state.allChecking,
-			modulesCheck: modulesLanded && modulesTicket !== void 0 ? landed(state.modulesCheck, modulesTicket, seq$1.modules, modulesOk, now) : state.modulesCheck,
-			pluginsCheck: pluginsLanded && pluginsTicket !== void 0 ? landed(state.pluginsCheck, pluginsTicket, seq$1.plugins, pluginsOk, now) : state.pluginsCheck
+			...check ? { modulesCheck: landed(state.modulesCheck, modulesTicket, seq$1.modules, payload !== null, Date.now()) } : {}
+		});
+	});
+	const pluginsRead = pluginsTicket === void 0 ? null : readPluginsOnce(run.force, check).then((response) => {
+		if (at !== epoch || response === null || superseded(run, "plugins", pluginsTicket)) return;
+		const ok = response.ok === true;
+		publish$1({
+			...state,
+			plugins: ok ? check ? response.plugins : withPreviousPluginLatest(response.plugins, state.plugins ?? []) : state.plugins,
+			...check ? { pluginsCheck: landed(state.pluginsCheck, pluginsTicket, seq$1.plugins, ok, Date.now()) } : {}
+		});
+	});
+	const promise = Promise.all([modulesRead, pluginsRead]).then(() => {
+		if (at !== epoch || !check || run.scope !== "all" || allTicket !== allSeq) return;
+		if (!state.allChecking) return;
+		publish$1({
+			...state,
+			allChecking: false
 		});
 	}).finally(() => {
-		if (inFlight.get(scope)?.promise === promise) inFlight.delete(scope);
+		if (inFlight.get(key)?.promise === promise) inFlight.delete(key);
 	});
-	inFlight.set(scope, {
-		force,
+	inFlight.set(key, {
 		epoch: at,
 		promise
 	});
 	return promise;
 }
+function runModuleVersionsRead(force = false, fresh = false, scope = "all") {
+	return runRead({
+		kind: "check",
+		force,
+		fresh,
+		scope
+	});
+}
+function runInstalledRead(options = {}) {
+	return runRead({
+		kind: "data",
+		force: false,
+		fresh: options.fresh === true,
+		scope: "all"
+	});
+}
 function useModuleVersions() {
 	const value = useSyncExternalStore(subscribeModuleVersions, moduleVersionsValue);
 	const factRev = useFactRevision(CAPABILITY_FACT);
-	const mountedRef = useRef(false);
 	useEffect(() => {
-		const first = !mountedRef.current;
-		mountedRef.current = true;
-		if (first && !shouldProbeOnEnter({
-			checkedAt: moduleVersionsCheckedAt(state),
-			now: Date.now(),
-			staleMs: MARKET_STALE_MS
-		})) return;
-		runModuleVersionsRead(false);
+		runInstalledRead();
 	}, [factRev]);
 	const reload = useCallback((options) => {
-		runModuleVersionsRead(options?.force === true, options?.fresh === true, options?.scope ?? "all");
+		if (options?.check === true) {
+			runModuleVersionsRead(options.force === true, options.fresh === true, options.scope ?? "all");
+			return;
+		}
+		runInstalledRead({ fresh: options?.fresh === true });
 	}, []);
 	return {
 		...value,
@@ -10560,29 +10638,36 @@ function useMarketReload(input) {
 			bumpModuleVersionsEpoch();
 			bumpCapabilityEpoch();
 			forceProbe();
-			reloadVersions({
-				force: true,
-				fresh: true
-			});
-			return;
-		}
-		reloadCapability();
+		} else reloadCapability();
 		reloadVersions();
 	}, [
 		reloadCapability,
 		reloadVersions,
 		forceProbe
 	]);
-	const checkPart = useCallback((part) => reloadVersions({
-		force: true,
-		fresh: true,
-		scope: part
-	}), [reloadVersions]);
+	const check = useCallback((options) => {
+		reloadVersions({
+			check: true,
+			force: options?.force === true,
+			fresh: true,
+			...options?.scope === void 0 ? {} : { scope: options.scope }
+		});
+	}, [reloadVersions]);
+	const recheck = useCallback(() => {
+		bumpCapabilityEpoch();
+		forceProbe();
+		check({ force: true });
+	}, [check, forceProbe]);
+	const checkPart = useCallback((part) => {
+		check({
+			force: true,
+			scope: part
+		});
+	}, [check]);
 	const enteredRef = useRef(false);
 	useEffect(() => {
 		if (enteredRef.current) return;
 		enteredRef.current = true;
-		reloadVersions();
 		if (!shouldProbeOnEnter({
 			checkedAt,
 			now: Date.now(),
@@ -10590,13 +10675,15 @@ function useMarketReload(input) {
 		})) return;
 		markNextProbeSilent();
 		forceProbe();
+		check();
 	}, [
 		checkedAt,
 		forceProbe,
-		reloadVersions
+		check
 	]);
 	return {
 		reload,
+		recheck,
 		checkPart
 	};
 }
@@ -11293,7 +11380,7 @@ function MarketPanel({ t, units, titleOf }) {
 	const openAddModule = useCallback(() => setAdding(true), []);
 	const updates = useMemo(() => marketUpdatesOf(modules), [modules]);
 	const installed = modules === null ? void 0 : withClientRefusals(modules, units.refusals());
-	const { reload, checkPart } = useMarketReload({
+	const { reload, recheck, checkPart } = useMarketReload({
 		checkedAt,
 		forceProbe,
 		reloadCapability,
@@ -11324,7 +11411,7 @@ function MarketPanel({ t, units, titleOf }) {
 		busy,
 		checking: checking || versionsAllChecking,
 		onTab: setTab,
-		onReload: () => reload({ force: true }),
+		onReload: recheck,
 		onAdd: openAddModule
 	}), devMarket.strip, /* @__PURE__ */ createElement("div", {
 		id: `${MARKET_PANEL_ID}-panel-installed`,
@@ -12954,8 +13041,27 @@ var BootGate_module_default = {
 function failedStepText(guidance, t) {
 	if (guidance === "path") return t("env.stepFailed.path");
 	if (guidance === "shell") return t("env.stepFailed.shell");
+	if (guidance === "host") return t("env.stepFailed.host");
 	return t("env.stepFailed.install");
 }
+function guidanceTextOf(guidance, t) {
+	if (guidance === "path") return {
+		why: t("env.fix.whyPath"),
+		step: t("env.fix.stepPath")
+	};
+	if (guidance === "shell") return {
+		why: t("env.fix.whyShell"),
+		step: t("env.fix.stepShell")
+	};
+	if (guidance === "host") return {
+		why: t("env.fix.whyHost"),
+		step: t("env.fix.stepHost")
+	};
+	return {
+		why: t("env.fix.why"),
+		step: t("env.fix.step")
+	};
+}
 function stepDetailText(step, snapshot, t) {
 	if (step.status === "failed") return failedStepText(snapshot.guidance, t);
 	if (step.status === "pending" || step.status === "running") return "";
@@ -13299,10 +13405,9 @@ function createBootGate(ctx, options = {}) {
 		errorBox.hidden = snapshot.error === void 0;
 		const commandText = snapshot.steps.find((step) => step.status === "failed" && step.command !== void 0)?.command;
 		const guidance = snapshot.guidance ?? "install";
-		const why = guidance === "path" ? t("env.fix.whyPath") : guidance === "shell" ? t("env.fix.whyShell") : t("env.fix.why");
-		const step = guidance === "path" ? t("env.fix.stepPath") : guidance === "shell" ? t("env.fix.stepShell") : t("env.fix.step");
-		fixWhy.textContent = why;
-		fixStep.textContent = step;
+		const advice = guidanceTextOf(guidance, t);
+		fixWhy.textContent = advice.why;
+		fixStep.textContent = advice.step;
 		const showCommand = guidance === "install" && commandText !== void 0;
 		fixCommand.set(showCommand ? commandText : void 0);
 		fixAdvice.textContent = !showCommand ? "" : snapshot.failure === "permission" ? t("env.fix.permission") : snapshot.failure === "network" ? t("env.fix.network") : "";

package/dist/host/index.js

@@ -843,6 +843,29 @@ function refusalReason() {
 //#endregion
 //#region ../shared/dist/host/shell.js
 var DEFAULT_MAX_BYTES$3 = 8388608;
+var GUARD_SLACK_MS = 1e3;
+function stalledResult() {
+	return {
+		exitCode: null,
+		timedOut: true,
+		aborted: false,
+		stdout: "",
+		stderr: "",
+		truncated: false,
+		stalled: true
+	};
+}
+async function settleWithin(work, limitMs) {
+	let timer;
+	const guard = new Promise((resolve) => {
+		timer = setTimeout(() => resolve(null), limitMs);
+	});
+	try {
+		return await Promise.race([work, guard]);
+	} finally {
+		if (timer !== void 0) clearTimeout(timer);
+	}
+}
 async function runShell(shell, command, options = {}) {
 	const { workdir, timeoutMs = GIT_TIMEOUT_MS, signal } = options;
 	const spec = shell.resolve({
@@ -853,15 +876,18 @@ async function runShell(shell, command, options = {}) {
 		stdoutMaxBytes: DEFAULT_MAX_BYTES$3,
 		...signal === void 0 ? {} : { signal }
 	});
-	const result = await (await shell.execute(spec)).result();
-	return {
-		exitCode: result.exitCode,
-		timedOut: result.timedOut === true,
-		aborted: result.aborted === true,
-		stdout: result.stdout.text,
-		stderr: result.stderr.text,
-		truncated: result.stdout.truncated || result.stderr.truncated
-	};
+	return await settleWithin((async () => {
+		const result = await (await shell.execute(spec)).result();
+		return {
+			exitCode: result.exitCode,
+			timedOut: result.timedOut === true,
+			aborted: result.aborted === true,
+			stdout: result.stdout.text,
+			stderr: result.stderr.text,
+			truncated: result.stdout.truncated || result.stderr.truncated,
+			stalled: false
+		};
+	})(), timeoutMs + GUARD_SLACK_MS) ?? stalledResult();
 }
 //#endregion
 //#region ../shared/dist/host/shell-text.js
@@ -6583,7 +6609,7 @@ async function workbenchVersion(supply, input) {
 	const spec = dependencyReader(input.dir)(PLUGIN_ID);
 	const registry = read.registry ?? input.fallback;
 	const shell = input.shell;
-	const queried = read.local === true || shell === void 0 || registry === void 0 ? void 0 : await supply.latestVersion({
+	const queried = read.local === true || !input.check || shell === void 0 || registry === void 0 ? void 0 : await supply.latestVersion({
 		shell,
 		name: read.pkg,
 		registry,
@@ -6620,6 +6646,7 @@ function moduleVersionsHandler(ctx, shell, running, selfUpdate) {
 		const found = supply.profileModules(dir);
 		const refusals = new Map((ctx.get("workbenchUnits")?.refusals() ?? []).filter((one) => one.unit !== "").map((one) => [one.unit, one.reasons]));
 		const force = param(search, "force") === "1";
+		const check = param(search, "check") !== "0";
 		const fallback = (await manager.registries())?.resolved ?? void 0;
 		const dependencyOf = dependencyReader(dir);
 		const modules = await Promise.all(found.map(async (module) => {
@@ -6627,7 +6654,7 @@ function moduleVersionsHandler(ctx, shell, running, selfUpdate) {
 			const fromRegistry = module.fromRegistry !== false;
 			const registry = fromRegistry ? module.registry ?? fallback : void 0;
 			const spec = dependencyOf(module.pkg);
-			const latest = local || !fromRegistry || shell === void 0 || registry === void 0 ? void 0 : await supply.latestVersion({
+			const latest = local || !fromRegistry || !check || shell === void 0 || registry === void 0 ? void 0 : await supply.latestVersion({
 				shell,
 				name: module.pkg,
 				registry,
@@ -6662,7 +6689,7 @@ function moduleVersionsHandler(ctx, shell, running, selfUpdate) {
 				...local ? {
 					local: true,
 					latestUnavailable: "local"
-				} : latest !== void 0 ? {} : { latestUnavailable: !fromRegistry ? "not-registry" : registry === void 0 ? "no-registry" : "probe-failed" },
+				} : latest !== void 0 ? {} : !fromRegistry ? { latestUnavailable: "not-registry" } : registry === void 0 ? { latestUnavailable: "no-registry" } : check ? { latestUnavailable: "probe-failed" } : {},
 				...refused === void 0 ? {} : { refused },
 				...spec === void 0 ? {} : { spec },
 				...registry === void 0 ? {} : { registry }
@@ -6681,6 +6708,7 @@ function moduleVersionsHandler(ctx, shell, running, selfUpdate) {
 			shell,
 			fallback,
 			force,
+			check,
 			...running === void 0 ? {} : { running },
 			...followUp === void 0 ? {} : { followUp },
 			logger: ctx.logger
@@ -16643,7 +16671,7 @@ var INSTALLED_PLUGINS_ROUTE = "panels/plugins";
 //#endregion
 //#region src/modules/panels/model/plugin-section.ts
 async function installedPlugins(options) {
-	const { ledger, shell, force = false } = options;
+	const { ledger, shell, force = false, check = true } = options;
 	const supply = options.supply ?? requireSupply();
 	const rows = [];
 	for (const entry of ledger.list()) {
@@ -16651,7 +16679,8 @@ async function installedPlugins(options) {
 			shell,
 			package: entry.package,
 			registry: entry.registry,
-			force
+			force,
+			check
 		});
 		rows.push({
 			pkg: entry.package,
@@ -16676,7 +16705,8 @@ function pluginRoutes(options) {
 				ledger: options.ledger,
 				...options.shell === void 0 ? {} : { shell: options.shell },
 				...options.supply === void 0 ? {} : { supply: options.supply },
-				force: param(search, "force") === "1"
+				force: param(search, "force") === "1",
+				check: param(search, "check") !== "0"
 			})
 		};
 	} };

package/dist/types/app/layouts/env-gate/gate-text.d.ts

@@ -2,6 +2,11 @@ import type { Translate } from '@dsh-workbench/shared';
 import type { PreflightBridgeIssue, PreflightGuidance, PreflightSnapshot, PreflightStep } from '@dsh-workbench/shared/host';
 import type { RuntimeProfile } from '@dsh-workbench/shared';
 export declare function failedStepText(guidance: PreflightGuidance | undefined, t: Translate): string;
+export interface GuidanceText {
+    readonly why: string;
+    readonly step: string;
+}
+export declare function guidanceTextOf(guidance: PreflightGuidance | undefined, t: Translate): GuidanceText;
 export declare function stepDetailText(step: PreflightStep, snapshot: PreflightSnapshot, t: Translate): string;
 export declare function gateHintOf(snapshot: PreflightSnapshot, t: Translate): string;
 export declare function showsRawDetails(snapshot: PreflightSnapshot): boolean;

package/dist/types/app/layouts/market/use-market-reload.d.ts

@@ -1,8 +1,14 @@
-import { type ModuleVersionsView, type VersionsPart } from './use-module-versions';
+import { type ModuleVersionsView, type VersionsPart, type VersionsScope } from './use-module-versions';
+export interface MarketReloadOptions {
+    readonly force?: boolean;
+}
+export interface MarketCheckOptions {
+    readonly force?: boolean;
+    readonly scope?: VersionsScope;
+}
 export interface MarketReload {
-    readonly reload: (options?: {
-        readonly force?: boolean;
-    }) => void;
+    readonly reload: (options?: MarketReloadOptions) => void;
+    readonly recheck: () => void;
     readonly checkPart: (part: VersionsPart) => void;
 }
 export interface MarketReloadInput {

package/dist/types/app/layouts/market/use-module-versions.d.ts

@@ -18,19 +18,19 @@ export interface ModuleVersionsState {
     readonly modulesCheck: VersionsCheck;
     readonly pluginsCheck: VersionsCheck;
 }
-export interface ModuleVersionsView extends ModuleVersionsState {
-    readonly checking: boolean;
-    reload(options?: {
-        readonly force?: boolean;
-        readonly fresh?: boolean;
-        readonly scope?: VersionsScope;
-    }): void;
-}
 export interface ModuleVersionsRead {
+    check?: boolean;
     force?: boolean;
     fresh?: boolean;
     scope?: VersionsScope;
 }
+export interface InstalledReadOptions {
+    readonly fresh?: boolean;
+}
+export interface ModuleVersionsView extends ModuleVersionsState {
+    readonly checking: boolean;
+    reload(options?: ModuleVersionsRead): void;
+}
 export declare function bumpModuleVersionsEpoch(): void;
 export declare function moduleVersionsValue(): ModuleVersionsState;
 export declare function resetModuleVersions(): void;
@@ -39,4 +39,5 @@ export declare function withMarketUpdates(modules: readonly ModuleVersion[], row
 export declare function moduleVersionsCheckedAt(now: ModuleVersionsState): number | null;
 export declare function moduleVersionsChecking(value: ModuleVersionsState): boolean;
 export declare function runModuleVersionsRead(force?: boolean, fresh?: boolean, scope?: VersionsScope): Promise<void>;
+export declare function runInstalledRead(options?: InstalledReadOptions): Promise<void>;
 export declare function useModuleVersions(): ModuleVersionsView;

package/dist/types/app/layouts/rightbar/MarketView.d.ts

@@ -9,6 +9,7 @@ import type { MarketMock } from './market-mock';
 import type { ModuleUpdateMap } from './market-rows';
 import type { WorkbenchSelfUpdate, WorkbenchVersion } from '../../../kernel/contract/bundle-install';
 import type { VersionsCheck, VersionsPart } from '../market/use-module-versions';
+import type { MarketReloadOptions } from '../market/use-market-reload';
 export interface MarketViewProps {
     readonly t: Translate;
     readonly titleOf: TitleResolve;
@@ -17,9 +18,7 @@ export interface MarketViewProps {
     readonly capabilities: CapabilityMap | null;
     readonly runtimePluginMarket?: boolean | undefined;
     readonly freshness: MarketFreshness;
-    readonly onChanged: (options?: {
-        readonly force?: boolean;
-    }) => void;
+    readonly onChanged: (options?: MarketReloadOptions) => void;
     readonly onPending?: ((pending: boolean) => void) | undefined;
     readonly updates?: ModuleUpdateMap | undefined;
     readonly modulesCheck?: VersionsCheck | undefined;

package/dist/types/app/layouts/rightbar/market-act.d.ts

@@ -2,6 +2,7 @@ import type { Translate, WriteOutcome } from '@dsh-workbench/shared';
 import type { MarketFailure, MarketRow } from './market-row-types';
 import { type MarketRowAction } from './market-rows';
 import { type HeldRow, type Pending } from './market-view-text';
+import type { MarketReloadOptions } from '../market/use-market-reload';
 export interface MarketActSeats {
     readonly setPending: (next: Pending | null) => void;
     readonly setHeld: (next: HeldRow | undefined) => void;
@@ -15,8 +16,6 @@ export interface MarketActOptions {
     readonly rowOf: (id: string) => MarketRow | undefined;
     readonly seats: MarketActSeats;
     readonly send: (body: Record<string, unknown>) => Promise<WriteOutcome<unknown>>;
-    readonly onChanged: (options?: {
-        readonly force?: boolean;
-    }) => void;
+    readonly onChanged: (options?: MarketReloadOptions) => void;
 }
 export declare function marketActOf(options: MarketActOptions): (id: string, action: MarketRowAction) => Promise<void>;

package/dist/types/modules/panels/model/plugin-section.d.ts

@@ -6,6 +6,7 @@ export declare function installedPlugins(options: {
     readonly ledger: PluginLedger;
     readonly shell?: DshShell | undefined;
     readonly force?: boolean;
+    readonly check?: boolean;
     readonly supply?: SupplyPort | undefined;
 }): Promise<readonly InstalledPlugin[]>;
 export declare function pluginRoutes(options: {

package/dist/types/shared/hooks/bundle-queries.d.ts

@@ -3,5 +3,5 @@ import { type BundleInspectionPayload, type BundleRegistriesPayload, type Module
 import { type InstalledPluginsPayload } from '../api/installed-plugins';
 export declare function readBundleRegistries(): Promise<ApiResponse<BundleRegistriesPayload>>;
 export declare function readBundleInspection(spec: string, registry?: string): Promise<ApiResponse<BundleInspectionPayload>>;
-export declare function readModuleVersions(force?: boolean): Promise<ApiResponse<ModuleVersionsPayload>>;
-export declare function readInstalledPlugins(force?: boolean): Promise<ApiResponse<InstalledPluginsPayload>>;
+export declare function readModuleVersions(force?: boolean, check?: boolean): Promise<ApiResponse<ModuleVersionsPayload>>;
+export declare function readInstalledPlugins(force?: boolean, check?: boolean): Promise<ApiResponse<InstalledPluginsPayload>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/core",
-  "version": "1.1.11",
+  "version": "1.1.13",
   "description": "个人工作台：Agent 工作台（左栏 + 常驻对话 + 自研右侧数据面板）。",
   "type": "module",
   "icon": "./icon.svg",
@@ -100,8 +100,8 @@
     "proper-lockfile": "^4.1.2",
     "which": "^7.0.0",
     "write-file-atomic": "^8.0.0",
-    "@dsh-workbench/shared": "1.1.11",
-    "@dsh-workbench/adapters-default": "1.1.11"
+    "@dsh-workbench/shared": "1.1.13",
+    "@dsh-workbench/adapters-default": "1.1.13"
   },
   "license": "MIT",
   "repository": {