dsh-update-status 0.1.12 → 0.2.1

package/lib/client.js

@@ -4,37 +4,28 @@ window.__ModuleLoader__.load({
 		var module = { exports: {} };
 		module.exports;
 		let react_jsx_runtime = require("react/jsx-runtime");
-		//#region src/shared/channels.ts
-		const CHANNEL_ORDER = {
-			latest: 0,
-			next: 1,
-			alpha: 2
-		};
+		//#region src/shared/visual-state.ts
 		/**
-		* Reduce raw dist-tags to user-meaningful choices without losing Host facts.
-		* The selected channel and stable return path are always present; every other
-		* row must carry a version no earlier row already shows.
+		* Only a read the plugin could not complete is a chip-level problem.
+		*
+		* An advisory notice — a preview channel this bundle has not been verified against,
+		* say — leaves the chip surface alone and belongs in the panel. Repainting the brand
+		* row for a plugin-side bookkeeping fact is the surprise the breathing dot replaced:
+		* an operator who upgrades DSH ahead of this bundle must not watch the chip turn red.
 		*
-		* A channel is deliberately NOT hidden just because it currently points at the
-		* release that is running. Following a channel is a statement about future
-		* releases, and `currentVersion` still rides the input for the caller's own
-		* rendering, but filtering on it created a deadlock: while running the version
-		* published on `alpha`, the `alpha` row disappeared, so the one channel a user
-		* on that line would want to follow could never be selected — the only way to
-		* see it was to already follow it.
+		* A Host older than `warningKind` sends no field at all; `undefined` then keeps the
+		* previous behaviour (any warning is a problem) rather than silently dropping a real
+		* failure on the floor.
 		*/
-		function visibleChannelReleases(status) {
-			const ordered = [...status.channels].sort((left, right) => CHANNEL_ORDER[left.channel] - CHANNEL_ORDER[right.channel]);
-			const mandatory = /* @__PURE__ */ new Set(["latest", status.channel]);
-			const visible = ordered.filter((release) => mandatory.has(release.channel));
-			const seenVersions = new Set(visible.map((release) => release.version).filter((version) => version !== null));
-			for (const release of ordered) {
-				if (mandatory.has(release.channel) || release.version === null) continue;
-				if (seenVersions.has(release.version)) continue;
-				visible.push(release);
-				seenVersions.add(release.version);
-			}
-			return visible.sort((left, right) => CHANNEL_ORDER[left.channel] - CHANNEL_ORDER[right.channel]);
+		function isChipProblem(status) {
+			if (status === null) return false;
+			if (status.warningKind === void 0) return status.warning !== null;
+			return status.warningKind === "failure";
+		}
+		function visualState(status, loading, error) {
+			if (loading) return "loading";
+			if (error !== null || isChipProblem(status)) return status?.hasUpdate === true ? "update" : "problem";
+			return status?.hasUpdate === true ? "update" : "current";
 		}
 		//#endregion
 		//#region src/shared/types.ts
@@ -45,9 +36,13 @@ window.__ModuleLoader__.load({
 		* `harness.handle` / `host.call` are dynamic-Cordis-only closure APIs. The
 		* endpoint vocabulary remains deliberately small and private to this plugin
 		* channel.
+		*
+		* There is ONE release line, not a channel catalogue: the Host reports the
+		* newest version the npm registry publishes under any dist-tag, and the client
+		* compares it with the running version. `latest`, `next` and `alpha` are npm's
+		* bookkeeping, not a user choice this plugin asks anyone to make.
 		*/
 		const PLUGIN_ID$1 = "dsh-update-status";
-		const PACKAGE_NAME = "@deepseek-ai/dsh";
 		/** Shared Connection RPC channel. Custom prefixes 405 on the SPA fallback. */
 		const UPDATE_STATUS_CHANNEL = "/api";
 		const MAX_CACHE_TTL_MINUTES = 1440;
@@ -58,54 +53,6 @@ window.__ModuleLoader__.load({
 			getStatus: "dsh-update-status.get-status",
 			checkUpdate: "dsh-update-status.check-update"
 		};
-		function isReleaseChannel(value) {
-			return value === "latest" || value === "next" || value === "alpha";
-		}
-		//#endregion
-		//#region src/shared/semver.ts
-		const SEMVER = /^(?:v)?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
-		function parseSemver(value) {
-			const match = SEMVER.exec(value.trim());
-			if (match === null) return void 0;
-			const major = Number(match[1]);
-			const minor = Number(match[2]);
-			const patch = Number(match[3]);
-			if (!Number.isSafeInteger(major) || !Number.isSafeInteger(minor) || !Number.isSafeInteger(patch)) return void 0;
-			return {
-				major,
-				minor,
-				patch,
-				prerelease: match[4] === void 0 ? [] : match[4].split(".")
-			};
-		}
-		//#endregion
-		//#region src/shared/preview-guidance.ts
-		/** Pinned guidance only: never execute a command or mutate the followed channel. */
-		function previewCommand(status, version) {
-			if (version === null || version.trim() !== version || parseSemver(version) === void 0) return null;
-			if (status.installKind === "npm-global") return `npm install -g ${PACKAGE_NAME}@${version}`;
-			if (status.installKind === "pnpm-global") return `pnpm add -g ${PACKAGE_NAME}@${version}`;
-			return null;
-		}
-		//#endregion
-		//#region src/shared/visual-state.ts
-		/**
-		* Only a read the plugin could not complete is a chip-level problem.
-		*
-		* An advisory notice — a preview channel this bundle has not been verified against,
-		* say — leaves the chip surface alone and belongs in the panel. Repainting the brand
-		* row for a plugin-side bookkeeping fact is the surprise the breathing dot replaced:
-		* an operator who upgrades DSH ahead of this bundle must not watch the chip turn red.
-		*
-		* A Host older than `warningKind` sends no field at all; `undefined` then keeps the
-		* previous behaviour (any warning is a problem) rather than silently dropping a real
-		* failure on the floor.
-		*/
-		function isChipProblem(status) {
-			if (status === null) return false;
-			if (status.warningKind === void 0) return status.warning !== null;
-			return status.warningKind === "failure";
-		}
 		//#endregion
 		//#region src/client/i18n.ts
 		const DICTIONARY = {
@@ -157,13 +104,9 @@ window.__ModuleLoader__.load({
 				zh: "当前运行版本",
 				en: "Current running version"
 			},
-			"panel.latest": {
-				zh: "所选通道版本",
-				en: "Selected channel version"
-			},
-			"panel.channels": {
-				zh: "可用发布通道",
-				en: "Available release channels"
+			"panel.newer": {
+				zh: "可更新至",
+				en: "Newer version available"
 			},
 			"panel.compatVerified": {
 				zh: "已验证兼容",
@@ -177,14 +120,6 @@ window.__ModuleLoader__.load({
 				zh: "已知不兼容",
 				en: "Known incompatible"
 			},
-			"panel.selectChannel": {
-				zh: "选择此通道",
-				en: "Select channel"
-			},
-			"panel.selectedChannel": {
-				zh: "已选择",
-				en: "Selected"
-			},
 			"panel.notChecked": {
 				zh: "尚未取得",
 				en: "Not available yet"
@@ -194,8 +129,8 @@ window.__ModuleLoader__.load({
 				en: "Update available"
 			},
 			"panel.currentState": {
-				zh: "未发现可用更新",
-				en: "No update found"
+				zh: "已是最新",
+				en: "Up to date"
 			},
 			"panel.cached": {
 				zh: "来自 Host 缓存",
@@ -221,10 +156,6 @@ window.__ModuleLoader__.load({
 				zh: "检查中…",
 				en: "Checking…"
 			},
-			"panel.switchingChannel": {
-				zh: "正在切换通道…",
-				en: "Switching channel…"
-			},
 			"panel.releaseNotes": {
 				zh: "发布说明",
 				en: "Release notes"
@@ -261,17 +192,13 @@ window.__ModuleLoader__.load({
 				zh: "无法检查 npm registry：{detail}",
 				en: "Unable to check the npm registry: {detail}"
 			},
-			"warning.channelUnavailable": {
-				zh: "npm registry 未发布 {channel} 通道。",
-				en: "The npm registry does not publish a {channel} channel."
-			},
 			"warning.versionIncomparable": {
-				zh: "无法按 SemVer 比较当前版本 {currentVersion} 与 {channel} 通道版本 {selectedVersion}。",
-				en: "Unable to compare the current version {currentVersion} with {channel} channel version {selectedVersion} using SemVer."
+				zh: "无法按 SemVer 比较当前版本 {currentVersion} 与线上版本 {latestVersion}。",
+				en: "Unable to compare the current version {currentVersion} with the published version {latestVersion} using SemVer."
 			},
-			"warning.previewUnverified": {
-				zh: "{channel} 是预览通道，版本 {version} 尚未验证与本插件兼容。",
-				en: "{channel} is a preview channel; version {version} has not been verified as compatible with this plugin."
+			"warning.versionUnverified": {
+				zh: "线上版本 {version} 尚未验证与本插件兼容。",
+				en: "Version {version} has not been verified as compatible with this plugin."
 			},
 			"warning.staleSchemastery": {
 				zh: "本插件解析到的 @deepseek-ai/schemastery（版本 {version}）来自 {path}，不是 DSH 自带的那份，偏好字段无法标记为 volatile。请删除该残留目录并重启 DSH：rm -rf {nodeModulesDir}",
@@ -289,42 +216,6 @@ window.__ModuleLoader__.load({
 				zh: "升级前请先确认 DSH 的安装方式；本插件无法代为执行升级。",
 				en: "Confirm how DSH was installed before upgrading; this plugin cannot perform the upgrade for you."
 			},
-			"panel.static": {
-				zh: "此连接只显示静态版本；请在运行 DSH 的本机打开侧栏查看完整更新信息。",
-				en: "This connection shows only the static version. Open the sidebar on the computer running DSH for full update details."
-			},
-			"preview.open": {
-				zh: "查看预览版升级方式",
-				en: "View preview upgrade instructions"
-			},
-			"preview.close": {
-				zh: "收起升级说明",
-				en: "Hide upgrade instructions"
-			},
-			"preview.follow": {
-				zh: "关注通道只影响检查结果，不代表已安装或已切换版本。",
-				en: "Following a channel only changes update checks, not the installed version."
-			},
-			"preview.target": {
-				zh: "目标版本",
-				en: "Target version"
-			},
-			"preview.risk": {
-				zh: "预览版本可能不稳定，插件兼容性尚需确认。执行前请保存工作、备份配置并结束运行中的任务；安装后需手动重启 DSH。此页面不会安装或重启。",
-				en: "Preview builds may be unstable and plugin compatibility needs checking. Save work, back up configuration and finish active tasks before executing. Restart DSH manually afterwards. This page never installs or restarts."
-			},
-			"preview.unavailable": {
-				zh: "暂无可确认的预览目标，请先检查更新。",
-				en: "No confirmed preview target. Check for updates first."
-			},
-			"preview.manual": {
-				zh: "当前安装方式无法安全生成命令，请先确认安装来源；源码安装需按其构建说明操作。",
-				en: "Cannot safely generate a command for this installation. Confirm its source; source checkouts require their build instructions."
-			},
-			"preview.same": {
-				zh: "此目标与当前运行版本相同，无需重复安装。",
-				en: "This target is already running; no reinstall is needed."
-			},
 			"settings.title": {
 				zh: "版本与更新",
 				en: "Version & updates"
@@ -334,28 +225,8 @@ window.__ModuleLoader__.load({
 				en: "Show the version-status entry in the sidebar"
 			},
 			"settings.sidebarHint": {
-				zh: "关闭后不再渲染品牌行里的版本芯片。不会执行或安排升级。",
-				en: "When off, the version chip in the brand row is not rendered. No update is run or scheduled."
-			},
-			"settings.channel": {
-				zh: "关注发布通道",
-				en: "Release channel to follow"
-			},
-			"settings.channelLatest": {
-				zh: "稳定版（latest，推荐）",
-				en: "Stable (latest, recommended)"
-			},
-			"settings.channelNext": {
-				zh: "候选版（next）",
-				en: "Release candidate (next)"
-			},
-			"settings.channelAlpha": {
-				zh: "预览版（alpha）",
-				en: "Preview (alpha)"
-			},
-			"settings.channelHint": {
-				zh: "预览通道可能包含未稳定接口或插件兼容性变化。这里只检查并生成命令，不会安装。",
-				en: "Preview channels may contain unstable APIs or plugin compatibility changes. This only checks and generates a command; it never installs."
+				zh: "关闭后不再渲染品牌行里的版本芯片，品牌行恢复为 DSH 官方内容。不会执行或安排升级。",
+				en: "When off, the version chip in the brand row is not rendered and the brand row falls back to DSH’s own content. No update is run or scheduled."
 			},
 			"settings.readonly": {
 				zh: "此连接的设置为只读；显示状态不受影响。",
@@ -377,16 +248,11 @@ window.__ModuleLoader__.load({
 		function warningText(warning, language = languageOf()) {
 			switch (warning.code) {
 				case "registry-unavailable": return t("warning.registryUnavailable", { detail: warning.detail }, language);
-				case "channel-unavailable": return t("warning.channelUnavailable", { channel: warning.channel }, language);
 				case "version-incomparable": return t("warning.versionIncomparable", {
 					currentVersion: warning.currentVersion,
-					channel: warning.channel,
-					selectedVersion: warning.selectedVersion
-				}, language);
-				case "preview-unverified": return t("warning.previewUnverified", {
-					channel: warning.channel,
-					version: warning.version
+					latestVersion: warning.latestVersion
 				}, language);
+				case "version-unverified": return t("warning.versionUnverified", { version: warning.version }, language);
 				case "stale-schemastery": {
 					const params = {
 						version: warning.version ?? "—",
@@ -433,11 +299,6 @@ window.__ModuleLoader__.load({
 			if (value.length <= 16) return value;
 			return value.slice(0, 15) + "…";
 		}
-		function channelLabel(channel) {
-			if (channel === "latest") return t("settings.channelLatest");
-			if (channel === "next") return t("settings.channelNext");
-			return t("settings.channelAlpha");
-		}
 		function compatibilityLabel(value) {
 			if (value === "verified") return t("panel.compatVerified");
 			if (value === "incompatible") return t("panel.compatIncompatible");
@@ -498,11 +359,6 @@ window.__ModuleLoader__.load({
 				]
 			});
 		}
-		function visualState(status, loading, error) {
-			if (loading) return "loading";
-			if (error !== null || isChipProblem(status)) return status?.hasUpdate === true ? "update" : "problem";
-			return status?.hasUpdate === true ? "update" : "current";
-		}
 		function badgeLabel(status, loading, error) {
 			const state = visualState(status, loading, error);
 			if (state === "loading") return t("brand.checking");
@@ -567,7 +423,7 @@ window.__ModuleLoader__.load({
 			};
 			if (status?.hasUpdate === true) return {
 				kind: "update",
-				text: t("panel.available")
+				text: `${t("panel.available")} · ${status.latestVersion ?? ""}`.trim()
 			};
 			if (status !== null) {
 				const warning = localizedWarning(status);
@@ -593,14 +449,63 @@ window.__ModuleLoader__.load({
 				element.focus();
 			} catch {}
 		}
+		/**
+		* The one upgrade command plus its copy affordance, shared by the panel and the
+		* settings section so both surfaces can never disagree about what to run.
+		*/
+		function CommandBlock({ command, disabled = false }) {
+			const commandRef = React.useRef(null);
+			const [copyMessage, setCopyMessage] = React.useState(null);
+			const copy = async () => {
+				setCopyMessage(null);
+				try {
+					if (!navigator.clipboard?.writeText) throw new Error("Clipboard API unavailable");
+					await navigator.clipboard.writeText(command);
+					setCopyMessage(t("panel.copied"));
+				} catch {
+					selectCommand(commandRef.current);
+					setCopyMessage(t("panel.copyFallback"));
+				}
+			};
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: "dus-command-label",
+					children: t("panel.command")
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", {
+					ref: commandRef,
+					className: "dus-command",
+					tabIndex: 0,
+					children: command
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "dus-actions dus-command-actions",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						className: "dus-action",
+						type: "button",
+						disabled,
+						onClick: () => {
+							copy();
+						},
+						children: t("panel.copy")
+					}), copyMessage !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: "dus-copy-message",
+						role: "status",
+						children: copyMessage
+					})]
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: "dus-note",
+					children: t("panel.commandNote")
+				})
+			] });
+		}
 		/** Full detail from whichever page the operator is on (the transport is authenticated). */
 		function UpdatePanel({ ui }) {
 			const panel = useObservable(ui.panel);
 			const preferences = useObservable(ui.preferences);
 			const snapshot = useObservable(ui.status);
-			const commandRef = React.useRef(null);
 			const dialogRef = React.useRef(null);
-			const [copyMessage, setCopyMessage] = React.useState(null);
 			const visible = panel.open && preferences.sidebarEnabled;
 			React.useLayoutEffect(() => {
 				if (!visible) return void 0;
@@ -629,19 +534,8 @@ window.__ModuleLoader__.load({
 			const status = snapshot.status;
 			const warning = status === null ? null : localizedWarning(status);
 			const summary = statusSummary(status, snapshot.loading, snapshot.error);
-			const switchingChannel = status !== null && status.channel !== preferences.channel;
-			const command = switchingChannel ? t("panel.switchingChannel") : status === null ? "—" : localizedUpgradeGuidance(status);
-			const copy = async () => {
-				setCopyMessage(null);
-				try {
-					if (!navigator.clipboard?.writeText) throw new Error("Clipboard API unavailable");
-					await navigator.clipboard.writeText(command);
-					setCopyMessage(t("panel.copied"));
-				} catch {
-					selectCommand(commandRef.current);
-					setCopyMessage(t("panel.copyFallback"));
-				}
-			};
+			const hasUpdate = status?.hasUpdate === true && status.latestVersion !== null;
+			const command = status === null || !hasUpdate ? "" : localizedUpgradeGuidance(status);
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("dialog", {
 				ref: dialogRef,
 				className: "dus-overlay-root",
@@ -698,28 +592,29 @@ window.__ModuleLoader__.load({
 										children: status?.currentVersion ?? "…"
 									})]
 								}),
-								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								hasUpdate && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 									className: "dus-metadata-row",
 									children: [
-										/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 											className: "dus-meta-label",
-											children: [
-												t("panel.latest"),
-												" · ",
-												status === null ? "latest" : channelLabel(status.channel)
-											]
+											children: t("panel.newer")
 										}),
 										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", {
 											className: "dus-meta-value",
-											children: status?.latestVersion ?? t("panel.notChecked")
+											children: status.latestVersion
 										}),
-										status?.publishedAt !== null && status?.publishedAt !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+										status.publishedAt !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 											className: "dus-meta-sub",
 											children: [
 												t("panel.publishedAt"),
 												": ",
 												timeText(status.publishedAt)
 											]
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+											className: "dus-meta-sub dus-compat",
+											"data-compatibility": status.compatibility,
+											children: compatibilityLabel(status.compatibility)
 										})
 									]
 								}),
@@ -742,39 +637,6 @@ window.__ModuleLoader__.load({
 								})
 							]
 						}),
-						status !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-							className: "dus-channel-list",
-							"aria-label": t("panel.channels"),
-							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-								className: "dus-command-label",
-								children: t("panel.channels")
-							}), visibleChannelReleases(status).map((release) => {
-								const selected = release.channel === preferences.channel;
-								return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-									className: "dus-channel-row",
-									"data-selected": selected || void 0,
-									children: [
-										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: channelLabel(release.channel) }),
-										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", { children: release.version ?? "—" }),
-										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-											className: "dus-channel-compat",
-											"data-compatibility": release.compatibility,
-											children: compatibilityLabel(release.compatibility)
-										}),
-										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-											className: "dus-channel-action",
-											type: "button",
-											disabled: selected || !preferences.writable || release.version === null,
-											"aria-label": `${selected ? t("panel.selectedChannel") : t("panel.selectChannel")}: ${channelLabel(release.channel)}`,
-											onClick: () => {
-												ui.preferences.setChannel(release.channel);
-											},
-											children: selected ? t("panel.selectedChannel") : t("panel.selectChannel")
-										})
-									]
-								}, release.channel);
-							})]
-						}),
 						warning !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
 							className: "dus-warning",
 							children: [
@@ -793,52 +655,25 @@ window.__ModuleLoader__.load({
 						}),
 						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 							className: "dus-actions",
-							children: [
-								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-									className: "dus-action",
-									type: "button",
-									disabled: snapshot.loading,
-									onClick: () => {
-										ui.status.refresh(void 0, preferences.cacheTtlMinutes);
-									},
-									children: snapshot.loading ? t("panel.checking") : t("panel.check")
-								}),
-								status !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
-									className: "dus-action",
-									href: status.changelogUrl,
-									target: "_blank",
-									rel: "noreferrer",
-									children: t("panel.releaseNotes")
-								}),
-								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-									className: "dus-action",
-									type: "button",
-									disabled: switchingChannel || status === null,
-									onClick: () => {
-										copy();
-									},
-									children: t("panel.copy")
-								})
-							]
-						}),
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-							className: "dus-command-label",
-							children: t("panel.command")
-						}),
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", {
-							ref: commandRef,
-							className: "dus-command",
-							tabIndex: 0,
-							children: command
-						}),
-						copyMessage !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-							className: "dus-copy-message",
-							role: "status",
-							children: copyMessage
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								className: "dus-action",
+								type: "button",
+								disabled: snapshot.loading,
+								onClick: () => {
+									ui.status.refresh(preferences.cacheTtlMinutes);
+								},
+								children: snapshot.loading ? t("panel.checking") : t("panel.check")
+							}), status !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
+								className: "dus-action",
+								href: status.changelogUrl,
+								target: "_blank",
+								rel: "noreferrer",
+								children: t("panel.releaseNotes")
+							})]
 						}),
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-							className: "dus-note",
-							children: t("panel.commandNote")
+						hasUpdate && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CommandBlock, {
+							command,
+							disabled: snapshot.loading
 						}),
 						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 							className: "dus-note",
@@ -852,9 +687,10 @@ window.__ModuleLoader__.load({
 		function UpdateSettings({ ui }) {
 			const preferences = useObservable(ui.preferences);
 			const snapshot = useObservable(ui.status);
-			const [showGuidance, setShowGuidance] = React.useState(false);
-			const previews = snapshot.status?.channels.filter((release) => release.channel !== "latest") ?? [];
-			const channelOptions = snapshot.status === null ? [{ channel: preferences.channel }] : visibleChannelReleases(snapshot.status);
+			const status = snapshot.status;
+			const summary = statusSummary(status, snapshot.loading, snapshot.error);
+			const hasUpdate = status?.hasUpdate === true && status.latestVersion !== null;
+			const command = status === null || !hasUpdate ? "" : localizedUpgradeGuidance(status);
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
 				className: "dus-settings",
 				children: [
@@ -889,94 +725,58 @@ window.__ModuleLoader__.load({
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: "dus-settings-card",
 						children: [
-							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
-								className: "dus-settings-field",
-								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("settings.channel") }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("select", {
-									className: "dus-channel-select",
-									value: preferences.channel,
-									disabled: !preferences.writable,
-									onChange: (event) => {
-										ui.preferences.setChannel(event.currentTarget.value);
-									},
-									children: channelOptions.map((option) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
-										value: option.channel,
-										children: channelLabel(option.channel)
-									}, option.channel))
-								})]
-							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-								className: "dus-settings-hint",
-								children: t("settings.channelHint")
-							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
 								className: "dus-settings-hint",
 								children: [
 									t("panel.current"),
 									": ",
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", { children: snapshot.status?.currentVersion ?? "…" })
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", { children: status?.currentVersion ?? "…" })
 								]
 							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-								className: "dus-settings-hint",
-								children: t("preview.follow")
+								className: "dus-state",
+								"data-kind": summary.kind,
+								children: summary.text
 							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-								className: "dus-action",
-								type: "button",
-								"aria-expanded": showGuidance,
-								onClick: () => {
-									setShowGuidance(!showGuidance);
-								},
-								children: t(showGuidance ? "preview.close" : "preview.open")
-							}),
-							showGuidance && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
-								"aria-label": t("preview.open"),
+							hasUpdate && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
+								className: "dus-settings-hint",
 								children: [
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-										className: "dus-warning",
-										children: t("preview.risk")
-									}),
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-										className: "dus-action",
-										type: "button",
-										disabled: snapshot.loading,
-										onClick: () => {
-											ui.status.refresh(void 0, preferences.cacheTtlMinutes);
-										},
-										children: t(snapshot.loading ? "panel.checking" : "panel.check")
-									}),
-									snapshot.error !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-										role: "alert",
-										children: snapshot.error
-									}),
-									previews.length === 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: t("preview.unavailable") }),
-									previews.map((release) => {
-										const status = snapshot.status;
-										const command = previewCommand(status, release.version);
-										return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-											className: "dus-settings-card",
-											children: [
-												/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", { children: [
-													channelLabel(release.channel),
-													" · ",
-													t("preview.target"),
-													": ",
-													/* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", { children: release.version ?? t("panel.notChecked") })
-												] }),
-												/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: compatibilityLabel(release.compatibility) }),
-												release.version === null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: t("preview.unavailable") }) : release.version === status.currentVersion ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: t("preview.same") }) : command !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: t("panel.command") }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", {
-													className: "dus-command",
-													tabIndex: 0,
-													children: command
-												})] }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: t("preview.manual") })
-											]
-										}, release.channel);
-									}),
-									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-										className: "dus-note",
-										children: t("panel.commandNote")
+									t("panel.newer"),
+									": ",
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", { children: status.latestVersion }),
+									" · ",
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: "dus-compat",
+										"data-compatibility": status.compatibility,
+										children: compatibilityLabel(status.compatibility)
 									})
 								]
+							}),
+							snapshot.error !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								role: "alert",
+								children: snapshot.error
+							}),
+							hasUpdate && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CommandBlock, {
+								command,
+								disabled: snapshot.loading
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: "dus-actions",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									className: "dus-action",
+									type: "button",
+									disabled: snapshot.loading,
+									onClick: () => {
+										ui.status.refresh(preferences.cacheTtlMinutes);
+									},
+									children: snapshot.loading ? t("panel.checking") : t("panel.check")
+								}), status !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
+									className: "dus-action",
+									href: status.changelogUrl,
+									target: "_blank",
+									rel: "noreferrer",
+									children: t("panel.releaseNotes")
+								})]
 							})
 						]
 					})
@@ -985,7 +785,6 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/client/contract.ts
-		/** Minimal structural client faces — runtime services stay owned by DSH. */
 		function errorMessage(error) {
 			return (error instanceof Error ? error.message : String(error)).replace(/\s+/g, " ").trim().slice(0, 220) || "unknown error";
 		}
@@ -999,19 +798,13 @@ window.__ModuleLoader__.load({
 				code: record.code,
 				detail: record.detail
 			};
-			if (record.code === "channel-unavailable" && isReleaseChannel(record.channel)) return {
-				code: record.code,
-				channel: record.channel
-			};
-			if (record.code === "version-incomparable" && typeof record.currentVersion === "string" && isReleaseChannel(record.channel) && typeof record.selectedVersion === "string") return {
+			if (record.code === "version-incomparable" && typeof record.currentVersion === "string" && typeof record.latestVersion === "string") return {
 				code: record.code,
 				currentVersion: record.currentVersion,
-				channel: record.channel,
-				selectedVersion: record.selectedVersion
+				latestVersion: record.latestVersion
 			};
-			if (record.code === "preview-unverified" && isReleaseChannel(record.channel) && typeof record.version === "string") return {
+			if (record.code === "version-unverified" && typeof record.version === "string") return {
 				code: record.code,
-				channel: record.channel,
 				version: record.version
 			};
 			if (record.code === "stale-schemastery") {
@@ -1030,8 +823,9 @@ window.__ModuleLoader__.load({
 		function updateStatusOf(value) {
 			if (value === null || typeof value !== "object" || Array.isArray(value)) return void 0;
 			const record = value;
-			if (typeof record.currentVersion !== "string" || typeof record.hasUpdate !== "boolean" || typeof record.cached !== "boolean" || typeof record.installKind !== "string" || typeof record.upgradeCommand !== "string" || typeof record.releaseUrl !== "string" || typeof record.changelogUrl !== "string" || typeof record.packageName !== "string" || !isReleaseChannel(record.channel) || !Array.isArray(record.channels) || record.canApplyInPlace !== false) return void 0;
+			if (typeof record.currentVersion !== "string" || typeof record.hasUpdate !== "boolean" || typeof record.cached !== "boolean" || typeof record.installKind !== "string" || typeof record.upgradeCommand !== "string" || typeof record.releaseUrl !== "string" || typeof record.changelogUrl !== "string" || typeof record.packageName !== "string" || record.canApplyInPlace !== false) return void 0;
 			if (!(record.installKind === "npm-global" || record.installKind === "pnpm-global" || record.installKind === "source-checkout" || record.installKind === "unknown")) return void 0;
+			if (record.compatibility !== "verified" && record.compatibility !== "unverified" && record.compatibility !== "incompatible") return void 0;
 			const latestVersion = record.latestVersion === null ? null : stringOrNull(record.latestVersion);
 			const checkedAt = record.checkedAt === null ? null : stringOrNull(record.checkedAt);
 			const warning = record.warning === null ? null : stringOrNull(record.warning);
@@ -1047,24 +841,11 @@ window.__ModuleLoader__.load({
 					warnings.push(parsed);
 				}
 			}
-			const channels = [];
-			for (const raw of record.channels) {
-				if (raw === null || typeof raw !== "object" || Array.isArray(raw)) return void 0;
-				const item = raw;
-				const version = item.version === null ? null : stringOrNull(item.version);
-				const channelPublishedAt = item.publishedAt === null ? null : stringOrNull(item.publishedAt);
-				if (!isReleaseChannel(item.channel) || item.version !== null && version === null || item.publishedAt !== null && channelPublishedAt === null || item.compatibility !== "verified" && item.compatibility !== "unverified" && item.compatibility !== "incompatible") return void 0;
-				channels.push({
-					channel: item.channel,
-					version,
-					publishedAt: channelPublishedAt,
-					compatibility: item.compatibility
-				});
-			}
 			return {
 				currentVersion: record.currentVersion,
 				latestVersion,
 				hasUpdate: record.hasUpdate,
+				compatibility: record.compatibility,
 				cached: record.cached,
 				checkedAt,
 				warning,
@@ -1076,8 +857,6 @@ window.__ModuleLoader__.load({
 				changelogUrl: record.changelogUrl,
 				publishedAt,
 				packageName: record.packageName,
-				channel: record.channel,
-				channels,
 				canApplyInPlace: false
 			};
 		}
@@ -1107,20 +886,24 @@ window.__ModuleLoader__.load({
 			};
 			/** First mount reads the Host's cached status; it never starts a browser timer. */
 			async load(cacheTtlMinutes = 360) {
-				await this.request(false, this.snapshot.status?.channel ?? "latest", cacheTtlMinutes);
+				await this.request(false, cacheTtlMinutes);
 			}
 			/** User gesture only: force the Host to bypass TTL (while retaining single-flight). */
-			async refresh(channel = this.snapshot.status?.channel ?? "latest", cacheTtlMinutes = 360) {
-				await this.request(true, channel, cacheTtlMinutes);
+			async refresh(cacheTtlMinutes = 360) {
+				await this.request(true, cacheTtlMinutes);
 			}
-			/** Channel selection re-projects the Host cache; it is not a forced refresh. */
-			async selectChannel(channel, cacheTtlMinutes = 360) {
-				for (let attempts = 0; attempts < 3 && !this.stopped && this.snapshot.status?.channel !== channel; attempts += 1) {
-					const pending = this.inFlight;
-					if (pending !== void 0 && !await pending) return;
-					if (this.stopped || this.snapshot.status?.channel === channel) return;
-					if (!await this.request(false, channel, cacheTtlMinutes)) return;
-				}
+			/**
+			* Ordinary read that waits out an in-flight request first.
+			*
+			* Used once per mount, when the stored cache policy arrives after the first
+			* read already started: joining that request would keep the default policy, so
+			* the follow-up read has to come after it settles.
+			*/
+			async reload(cacheTtlMinutes) {
+				const pending = this.inFlight;
+				if (pending !== void 0) await pending;
+				if (this.stopped) return;
+				await this.request(false, cacheTtlMinutes);
 			}
 			stop() {
 				this.stopped = true;
@@ -1131,7 +914,7 @@ window.__ModuleLoader__.load({
 				this.snapshot = next;
 				for (const listener of this.listeners) listener();
 			}
-			request(force, channel, cacheTtlMinutes) {
+			request(force, cacheTtlMinutes) {
 				if (this.inFlight !== void 0) return this.inFlight;
 				const rpc = this.connection.rpc;
 				if (rpc === void 0 || typeof rpc.call !== "function") {
@@ -1153,12 +936,8 @@ window.__ModuleLoader__.load({
 						const ttl = isCacheTtlMinutes(cacheTtlMinutes) ? cacheTtlMinutes : 360;
 						const raw = await rpc.call(UPDATE_STATUS_CHANNEL, endpoint, force ? {
 							force: true,
-							channel,
-							cacheTtlMinutes: ttl
-						} : {
-							channel,
 							cacheTtlMinutes: ttl
-						});
+						} : { cacheTtlMinutes: ttl });
 						if (raw === null || typeof raw !== "object" || Array.isArray(raw)) throw new Error("invalid update-status RPC response");
 						const envelope = raw;
 						if (envelope.ok !== true) throw new Error(typeof envelope.error?.message === "string" ? envelope.error.message : "update-status RPC failed");
@@ -1188,7 +967,6 @@ window.__ModuleLoader__.load({
 		};
 		const INITIAL_PREFERENCES = {
 			sidebarEnabled: true,
-			channel: "latest",
 			cacheTtlMinutes: 360,
 			writable: false,
 			status: "loading"
@@ -1212,7 +990,6 @@ window.__ModuleLoader__.load({
 					const status = raw.status === "ready" || raw.status === "unavailable" ? raw.status : "loading";
 					this.publish({
 						sidebarEnabled: value.sidebarEnabled !== false,
-						channel: isReleaseChannel(value.channel) ? value.channel : "latest",
 						cacheTtlMinutes: isCacheTtlMinutes(value.cacheTtlMinutes) ? value.cacheTtlMinutes : 360,
 						writable: raw.writable === true,
 						status
@@ -1235,7 +1012,6 @@ window.__ModuleLoader__.load({
 						const value = raw.value !== null && typeof raw.value === "object" && !Array.isArray(raw.value) ? raw.value : {};
 						this.publish({
 							sidebarEnabled: value.sidebarEnabled !== false,
-							channel: isReleaseChannel(value.channel) ? value.channel : "latest",
 							cacheTtlMinutes: isCacheTtlMinutes(value.cacheTtlMinutes) ? value.cacheTtlMinutes : 360,
 							writable: raw.writable === true,
 							status: raw.status === "ready" || raw.status === "unavailable" ? raw.status : "loading"
@@ -1245,18 +1021,6 @@ window.__ModuleLoader__.load({
 					}
 				});
 			}
-			setChannel(channel) {
-				const previous = this.snapshot;
-				this.publish({
-					...previous,
-					channel
-				});
-				const scope = this.scope;
-				if (scope === void 0 || !previous.writable) return;
-				scope.set("channel", channel).catch(() => {
-					this.publish(previous);
-				});
-			}
 			setCacheTtlMinutes(cacheTtlMinutes) {
 				if (!isCacheTtlMinutes(cacheTtlMinutes)) return;
 				const previous = this.snapshot;
@@ -1272,7 +1036,7 @@ window.__ModuleLoader__.load({
 			}
 			publish(next) {
 				const previous = this.snapshot;
-				if (previous.sidebarEnabled === next.sidebarEnabled && previous.channel === next.channel && previous.cacheTtlMinutes === next.cacheTtlMinutes && previous.writable === next.writable && previous.status === next.status) return;
+				if (previous.sidebarEnabled === next.sidebarEnabled && previous.cacheTtlMinutes === next.cacheTtlMinutes && previous.writable === next.writable && previous.status === next.status) return;
 				this.snapshot = next;
 				for (const listener of this.listeners) listener();
 			}
@@ -1789,19 +1553,11 @@ window.__ModuleLoader__.load({
 .dus-settings-card{border:1px solid var(--dsw-alias-border-l2);border-radius:10px;padding:12px}
 .dus-settings-toggle{align-items:flex-start;cursor:pointer;display:flex;gap:10px;font-size:13px;line-height:1.4}
 .dus-settings-toggle input{accent-color:var(--dsw-alias-state-business-primary);height:18px;margin:0;min-height:18px;min-width:18px;width:18px}
-.dus-settings-field{display:grid;font-size:13px;font-weight:600;gap:8px}
-.dus-channel-select{background:var(--dsw-specific-input-major);border:1px solid var(--dsw-alias-border-l2);border-radius:8px;color:inherit;font:inherit;min-height:40px;padding:0 10px;width:100%}
-.dus-channel-list{border-top:1px solid var(--dsw-alias-border-l2);margin:12px 0 0;padding-top:2px}
-.dus-channel-row{align-items:center;display:grid;font-size:11px;gap:8px;grid-template-columns:minmax(0,1fr) auto;line-height:1.4;padding:6px 0}
-.dus-channel-row[data-selected=true]{color:var(--dsw-alias-state-business-primary)}
-.dus-channel-row code{font-size:11px}
-.dus-channel-compat{color:var(--dsw-alias-label-secondary)}
-.dus-channel-action{background:transparent;border:1px solid var(--dsw-alias-border-l2);border-radius:7px;color:inherit;cursor:pointer;font-size:11px;justify-self:end;min-height:32px;padding:0 9px}
-.dus-channel-action:disabled{cursor:default;opacity:.55}
-.dus-channel-action:not(:disabled):hover{background:var(--dsw-alias-button-floating-hover)}
-.dus-channel-compat[data-compatibility=verified]{color:var(--dsw-alias-state-success-primary)}
-.dus-channel-compat[data-compatibility=incompatible]{color:var(--dsw-alias-state-error-primary)}
 .dus-settings-hint{color:var(--dsw-alias-label-secondary);font-size:12px;line-height:1.45;margin:8px 0 0}
+.dus-compat{color:var(--dsw-alias-label-secondary)}
+.dus-compat[data-compatibility=verified]{color:var(--dsw-alias-state-success-primary)}
+.dus-compat[data-compatibility=incompatible]{color:var(--dsw-alias-state-error-primary)}
+.dus-command-actions{align-items:center;margin:8px 0 0}
 @media (max-width:640px),(hover:none) and (pointer:coarse){.dus-panel{border-bottom:0;border-bottom-left-radius:0;border-bottom-right-radius:0;bottom:0;left:0;right:0;max-height:min(78dvh,calc(100dvh - env(safe-area-inset-top)));padding:16px max(16px,env(safe-area-inset-right)) max(16px,env(safe-area-inset-bottom)) max(16px,env(safe-area-inset-left));position:fixed;top:auto;width:100vw}.dus-action{min-height:40px;line-height:38px}.dus-close{height:40px;min-height:40px;min-width:40px;width:40px}}
 `;
 		//#endregion
@@ -1866,16 +1622,19 @@ window.__ModuleLoader__.load({
 			ctx.effect(() => {
 				const disposeStyles = installStyles();
 				const detach = preferences.attach(channel);
-				let selected = status.getSnapshot().status?.channel ?? "latest";
-				const syncPreferences = () => {
-					const next = preferences.getSnapshot();
-					if (next.channel !== selected) {
-						selected = next.channel;
-						status.selectChannel(selected, next.cacheTtlMinutes);
-					}
+				let usedCacheTtl = preferences.getSnapshot().cacheTtlMinutes;
+				let storedPolicyApplied = false;
+				const applyStoredPolicyOnce = () => {
+					if (storedPolicyApplied) return;
+					const snapshot = preferences.getSnapshot();
+					if (snapshot.status === "loading") return;
+					storedPolicyApplied = true;
+					if (snapshot.cacheTtlMinutes === usedCacheTtl) return;
+					usedCacheTtl = snapshot.cacheTtlMinutes;
+					status.reload(snapshot.cacheTtlMinutes);
 				};
-				syncPreferences();
-				const unsubscribe = preferences.subscribe(syncPreferences);
+				applyStoredPolicyOnce();
+				const unsubscribe = preferences.subscribe(applyStoredPolicyOnce);
 				status.load(preferences.getSnapshot().cacheTtlMinutes);
 				return () => {
 					stopped = true;
@@ -1911,10 +1670,27 @@ window.__ModuleLoader__.load({
 			if (typeof ctx.on === "function") try {
 				own(ctx.on("connection/reset", () => channel.reload()));
 			} catch {}
-			ctx.slots.inject("sidebar.brand.name", () => ctx.slots.register({
-				name: "sidebar.brand.name",
-				priority: -10
-			}, () => BrandName({ ui })));
+			ctx.slots.inject("sidebar.brand.name", () => {
+				let registration;
+				const syncRegistration = () => {
+					const enabled = preferences.getSnapshot().sidebarEnabled;
+					if (enabled && registration === void 0) registration = ctx.slots.register({
+						name: "sidebar.brand.name",
+						priority: -10
+					}, () => BrandName({ ui }));
+					else if (!enabled && registration !== void 0) {
+						registration();
+						registration = void 0;
+					}
+				};
+				syncRegistration();
+				const unsubscribe = preferences.subscribe(syncRegistration);
+				return () => {
+					unsubscribe();
+					registration?.();
+					registration = void 0;
+				};
+			});
 			ctx.slots.inject("shell.overlay", () => ctx.slots.register({
 				name: "shell.overlay",
 				id: "dsh-update-status",