@huaqiu/dsh-tool-plugin-update 0.6.5 → 0.6.7

package/lib/client.js

@@ -375,6 +375,108 @@ window.__ModuleLoader__.load({
 			}
 			return null;
 		}
+		/** Phases after which a job never runs again — polling stops and a result view
+		*  replaces the active-job view. */
+		const TERMINAL_PHASES = /* @__PURE__ */ new Set([
+			"done",
+			"failed",
+			"rolled-back",
+			"abandoned"
+		]);
+		const PHASE_VALUES = /* @__PURE__ */ new Set([
+			"queued",
+			"resolving",
+			"downloading",
+			"verifying",
+			"staging",
+			"activating",
+			"awaiting-host",
+			"restarting",
+			"verifying-after-restart",
+			"done",
+			"failed",
+			"rolled-back",
+			"abandoned"
+		]);
+		function asFiniteNumber(value) {
+			return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+		}
+		/** Defensively normalize one job payload from the wire into {@link UpdateJob}.
+		*  Unknown/older servers may omit fields; a malformed `phase` falls back to
+		*  `queued` rather than crashing the view. */
+		function normalizeJob(raw) {
+			if (raw === null || typeof raw !== "object") return null;
+			const r = raw;
+			if (typeof r.id !== "string" || r.id.length === 0) return null;
+			const phase = typeof r.phase === "string" && PHASE_VALUES.has(r.phase) ? r.phase : "queued";
+			const progressRaw = r.progress ?? {};
+			const percentRaw = asFiniteNumber(progressRaw.percent);
+			const progress = { percent: percentRaw === void 0 ? null : Math.min(100, Math.max(0, percentRaw)) };
+			const bytesDone = asFiniteNumber(progressRaw.bytesDone);
+			const bytesTotal = asFiniteNumber(progressRaw.bytesTotal);
+			const bytesPerSecond = asFiniteNumber(progressRaw.bytesPerSecond);
+			const etaSeconds = asFiniteNumber(progressRaw.etaSeconds);
+			if (bytesDone !== void 0) progress.bytesDone = bytesDone;
+			if (bytesTotal !== void 0) progress.bytesTotal = bytesTotal;
+			if (bytesPerSecond !== void 0) progress.bytesPerSecond = bytesPerSecond;
+			if (etaSeconds !== void 0) progress.etaSeconds = etaSeconds;
+			const job = {
+				id: r.id,
+				kind: r.kind === "runtime" ? "runtime" : "plugin-set",
+				targetVersion: typeof r.targetVersion === "string" ? r.targetVersion : "",
+				previousVersion: typeof r.previousVersion === "string" ? r.previousVersion : null,
+				startedAt: typeof r.startedAt === "string" ? r.startedAt : "",
+				updatedAt: typeof r.updatedAt === "string" ? r.updatedAt : "",
+				phase,
+				progress
+			};
+			if (typeof r.message === "string" && r.message.length > 0) job.message = r.message;
+			if (typeof r.logHint === "string" && r.logHint.length > 0) job.logHint = r.logHint;
+			if (Array.isArray(r.steps)) {
+				const steps = [];
+				for (const entry of r.steps) {
+					if (entry === null || typeof entry !== "object") continue;
+					const s = entry;
+					if (typeof s.name !== "string") continue;
+					const state = s.state === "running" || s.state === "installed" || s.state === "skipped" || s.state === "failed" ? s.state : "pending";
+					const step = {
+						name: s.name,
+						state
+					};
+					const pct = asFiniteNumber(s.percent);
+					if (pct !== void 0) step.percent = pct;
+					if (typeof s.message === "string" && s.message.length > 0) step.message = s.message;
+					steps.push(step);
+				}
+				if (steps.length > 0) job.steps = steps;
+			}
+			if (r.result !== null && typeof r.result === "object") {
+				const res = r.result;
+				const result = {
+					ok: res.ok === true,
+					installedVersion: typeof res.installedVersion === "string" ? res.installedVersion : null,
+					rolledBack: res.rolledBack === true,
+					finishedAt: typeof res.finishedAt === "string" ? res.finishedAt : ""
+				};
+				if (typeof res.errorCode === "string" && res.errorCode.length > 0) result.errorCode = res.errorCode;
+				if (typeof res.message === "string" && res.message.length > 0) result.message = res.message;
+				job.result = result;
+			}
+			return job;
+		}
+		/** Normalize a `GET /status` payload; an empty/absent body degrades to "no
+		*  active job" rather than throwing. */
+		function normalizeJobStatus(raw) {
+			if (raw === null || typeof raw !== "object") return {
+				activeJob: null,
+				recentJobs: []
+			};
+			const r = raw;
+			return {
+				activeJob: normalizeJob(r.activeJob),
+				recentJobs: Array.isArray(r.recentJobs) ? r.recentJobs.map(normalizeJob).filter((j) => j !== null) : []
+			};
+		}
 		async function request(path, init) {
 			const res = await fetch(`${UPDATE_BASE}${path}`, {
 				cache: "no-store",
@@ -459,87 +561,174 @@ window.__ModuleLoader__.load({
 				body: JSON.stringify({ url })
 			});
 		}
-		const COPY = {
-			zh: {
-				entryLabel: "插件更新",
-				entryTooltip: "查看可用的插件更新",
-				viewTitle: "插件更新",
-				viewIntro: "检查并安装可用的插件更新",
-				viewInfo: "在这里查看插件集的更新。标注为「被阻止」的插件因主机或 HQ Edge 版本不兼容而无法安装；已是最新的插件无需操作。",
-				refresh: "刷新",
-				close: "关闭",
-				loading: "正在读取插件更新…",
-				empty: "没有可用的插件更新",
-				checkFailed: "检查更新失败，请重试",
-				installAll: (count) => `安装 ${count} 项更新`,
-				installOne: "安装",
-				installing: "正在安装…（DSH 将自动重启）",
-				nothingToInstall: "暂无可安装的更新",
-				ignore: "忽略此版本",
-				unignore: "恢复提醒",
-				ignoredOffer: "已忽略当前插件集更新",
-				groupCount: (count) => `${count} 个插件`,
-				group: {
-					actionable: "待处理",
-					blocked: "无法安装",
-					ignored: "已忽略",
-					current: "已是最新"
-				},
-				state: {
-					current: "当前",
-					update: "可更新",
-					install: "待安装",
-					ignored: "已忽略",
-					blocked: "被阻止"
-				},
-				blockedReason: {
-					host: "不适用于当前 EDA 主机",
-					"hq-edge-version": "当前 HQ Edge 版本不兼容",
-					"runtime-unknown": "HQ Edge 版本未知，无法校验"
-				},
-				runtime: {
-					title: "HQ Edge 运行时",
-					current: "当前版本",
-					latest: "最新版本",
-					set: "发布插件集",
-					checkedAt: "上次检查",
-					source: "更新源",
-					unknown: "版本未知",
-					notConfigured: "未配置更新源",
-					note: "运行时更新由 EDA 安装器处理",
-					update: "安装运行时更新",
-					updateConfirm: (version) => `安装 HQ Edge 运行时 ${version}？HQ Edge 会先关闭并完成替换，然后重新启动。`,
-					updating: "正在下载并校验运行时包，可能需要一分钟…",
-					updateAccepted: "运行时更新已受理，HQ Edge 正在重启…",
-					sourceHint: "运行时更新清单的下载地址，保存后立即生效",
-					sourceEdit: "修改",
-					sourceSave: "保存",
-					sourceReset: "恢复默认",
-					saved: "更新源已保存，正在重新检查更新…",
-					saveFailed: "保存更新源失败",
-					sourceInputLabel: "运行时更新清单地址",
-					sourcePlaceholder: "https://gitee.com/huaqiu-electronics/dsh-pcb-eda/raw/main/edge-headless-release-manifest.json"
+		/**
+		* GET the durable job status: the currently active job (if any) plus a bounded
+		* list of recent jobs. This is what the panel reads BEFORE running discovery
+		* on open, so an in-flight install/runtime update is resumed instead of
+		* forgotten. An older hq-edge without the status route 404s — callers catch
+		* that and degrade to "no active job".
+		*/
+		function fetchJobStatus() {
+			return request("/status").then(normalizeJobStatus);
+		}
+		//#endregion
+		//#region src/client/copy.ts
+		/**
+		* Localized copy for the plugin-update UI (browser half).
+		*
+		* zh is the fallback, matching the rest of the Huaqiu plugin family
+		* (`<html lang>` drives the resolution via the shared sidebar-entry locale
+		* helpers). The wording follows the shell's own plugin manager
+		* (`ui-plugin-manager/src/client/locales.ts`) so both read as one product.
+		*
+		* @module
+		*/
+		const zh = {
+			entryLabel: "插件更新",
+			entryTooltip: "查看可用的插件更新",
+			viewTitle: "插件更新",
+			viewIntro: "检查并安装可用的插件更新",
+			viewInfo: "在这里查看插件集的更新。标注为「被阻止」的插件因主机或 HQ Edge 版本不兼容而无法安装；已是最新的插件无需操作。",
+			refresh: "刷新",
+			close: "关闭",
+			loading: "正在读取插件更新…",
+			empty: "没有可用的插件更新",
+			checkFailed: "检查更新失败，请重试",
+			installAll: (count) => `安装整套更新（${count} 项）`,
+			installOne: "安装整套",
+			installOneTip: "将安装整套 N 项更新并自动重启 DSH，而不仅是此插件",
+			installing: "正在安装…（DSH 将自动重启）",
+			retry: "重试",
+			checkedAt: (when) => `上次检查：${when}`,
+			checkFailedBanner: (message) => `检查更新失败：${message}`,
+			staleNote: "以下为上次成功检查的结果，可能已过期",
+			nothingToInstall: "暂无可安装的更新",
+			ignore: "忽略此版本",
+			unignore: "恢复提醒",
+			ignoredOffer: "已忽略当前插件集更新",
+			groupCount: (count) => `${count} 个插件`,
+			group: {
+				actionable: "待处理",
+				blocked: "无法安装",
+				ignored: "已忽略",
+				current: "已是最新"
+			},
+			state: {
+				current: "当前",
+				update: "可更新",
+				install: "待安装",
+				ignored: "已忽略",
+				blocked: "被阻止"
+			},
+			blockedReason: {
+				host: "不适用于当前 EDA 主机",
+				"hq-edge-version": "当前 HQ Edge 版本不兼容",
+				"runtime-unknown": "HQ Edge 版本未知，无法校验"
+			},
+			runtime: {
+				title: "HQ Edge 运行时",
+				current: "当前版本",
+				latest: "最新版本",
+				set: "发布插件集",
+				checkedAt: "上次检查",
+				source: "更新源",
+				unknown: "版本未知",
+				notConfigured: "未配置更新源",
+				note: "运行时更新由 EDA 安装器处理",
+				sizeLabel: "包大小",
+				update: "安装运行时更新",
+				updateConfirm: (version) => `安装 HQ Edge 运行时 ${version}？HQ Edge 会先关闭并完成替换，然后重新启动。`,
+				updating: "正在下载并校验运行时包…",
+				durationNote: "耗时取决于下载速度与包体大小；运行时包较大，替换后 HQ Edge 会自动重启。",
+				updateAccepted: "运行时更新已受理，HQ Edge 正在重启…",
+				size: (bytes) => `约 ${formatMb(bytes)}`,
+				lastResult: {
+					title: "上次运行时更新结果",
+					succeeded: "运行时更新成功",
+					failed: "运行时更新失败",
+					rolledBack: "运行时更新已回滚（已恢复旧版本）",
+					elevation: "系统级安装可能弹出 UAC 提权窗口；拒绝提权会导致替换失败并自动回滚到旧版本。"
 				},
-				pluginSource: {
-					title: "插件更新源",
-					hint: "插件更新清单的下载地址，保存后立即生效",
-					edit: "修改",
-					save: "保存",
-					reset: "恢复默认",
-					saved: "更新源已保存，正在重新检查更新…",
-					saveFailed: "保存更新源失败",
-					inputLabel: "插件更新清单地址",
-					placeholder: "https://gitee.com/huaqiu-electronics/dsh-pcb-eda/raw/main/plugins-release-manifest.json"
+				sourceHint: "运行时更新清单的下载地址，保存后立即生效",
+				sourceEdit: "修改",
+				sourceSave: "保存",
+				sourceReset: "恢复默认",
+				saved: "更新源已保存，正在重新检查更新…",
+				saveFailed: "保存更新源失败",
+				sourceInputLabel: "运行时更新清单地址",
+				sourcePlaceholder: "https://gitee.com/huaqiu-electronics/dsh-pcb-eda/raw/main/edge-headless-release-manifest.json"
+			},
+			pluginSource: {
+				title: "插件更新源",
+				hint: "插件更新清单的下载地址，保存后立即生效",
+				edit: "修改",
+				save: "保存",
+				reset: "恢复默认",
+				saved: "更新源已保存，正在重新检查更新…",
+				saveFailed: "保存更新源失败",
+				inputLabel: "插件更新清单地址",
+				placeholder: "https://gitee.com/huaqiu-electronics/dsh-pcb-eda/raw/main/plugins-release-manifest.json"
+			},
+			originOverride: "自定义",
+			originConfig: "默认配置",
+			originUnset: "未配置",
+			lastError: "上次检查失败",
+			installError: "安装失败",
+			installSuccess: "更新已安装，正在重启 DSH…",
+			confirmInstall: "确认安装",
+			cancel: "取消",
+			job: {
+				kindPluginSet: "插件集更新",
+				kindRuntime: "HQ Edge 运行时更新",
+				phase: {
+					queued: "排队中",
+					resolving: "解析版本",
+					downloading: "下载中",
+					verifying: "校验完整性",
+					staging: "暂存文件",
+					activating: "启用插件集",
+					"awaiting-host": "等待主机替换运行时",
+					restarting: "正在重启",
+					"verifying-after-restart": "重启后校验",
+					done: "已完成",
+					failed: "失败",
+					"rolled-back": "已回滚",
+					abandoned: "已中断"
 				},
-				originOverride: "自定义",
-				originConfig: "默认配置",
-				originUnset: "未配置",
-				lastError: "上次检查失败",
-				installError: "安装失败",
-				installSuccess: "更新已安装，正在重启 DSH…",
-				confirmInstall: "确认安装",
-				cancel: "取消"
+				willRestartDsh: "完成后 DSH 将自动重启，更新本身会在后台继续。",
+				willSwapRuntime: "HQ Edge 会下载完整运行时包并退出，由 EDA 主机替换后重启；系统级安装可能弹出 UAC 提权窗口。",
+				closeNote: "关闭此面板不会取消更新。",
+				bytes: (done, total) => `${done} / ${total}`,
+				speed: (v) => `${v}/s`,
+				eta: (s) => `剩余约 ${s}`,
+				nextDone: "正在完成，请稍候…",
+				resultDone: "更新已完成",
+				resultFailed: "更新失败",
+				resultRolledBack: "更新已回滚",
+				resultAbandoned: "更新未完成",
+				retry: "重新尝试（发起新的更新）",
+				recentTitle: "最近更新",
+				stepsTitle: "各组件进度",
+				logHint: (hint) => `日志标识：${hint}`
 			},
+			release: {
+				summaryTitle: "版本说明",
+				notesLink: "查看发布说明",
+				breakingTitle: "破坏性变更",
+				changesTitle: "更新内容",
+				advanced: "高级：更新源",
+				publishedAt: (when) => `发布于 ${when}`
+			}
+		};
+		/** Compact a byte count for display: "约 12.3 MB" / "约 480 MB". */
+		function formatMb(bytes) {
+			if (!Number.isFinite(bytes) || bytes <= 0) return "";
+			const mb = bytes / 1048576;
+			if (mb >= 100) return `${Math.round(mb)} MB`;
+			return `${mb.toFixed(1)} MB`;
+		}
+		const COPY = {
+			zh,
 			en: {
 				entryLabel: "Plugin Updates",
 				entryTooltip: "Review available plugin updates",
@@ -551,9 +740,14 @@ window.__ModuleLoader__.load({
 				loading: "Reading plugin updates…",
 				empty: "No plugin updates available",
 				checkFailed: "Failed to check for updates — please retry",
-				installAll: (count) => `Install ${count} update${count === 1 ? "" : "s"}`,
-				installOne: "Install",
+				installAll: (count) => `Install whole set (${count})`,
+				installOne: "Install set",
+				installOneTip: "Installs the whole set of N updates and restarts DSH — not just this plugin",
 				installing: "Installing… (DSH will restart)",
+				retry: "Retry",
+				checkedAt: (when) => `Last checked: ${when}`,
+				checkFailedBanner: (message) => `Update check failed: ${message}`,
+				staleNote: "Showing the last successful check — it may be stale",
 				nothingToInstall: "Nothing to install right now",
 				ignore: "Ignore this release",
 				unignore: "Show again",
@@ -587,10 +781,20 @@ window.__ModuleLoader__.load({
 					unknown: "Version unknown",
 					notConfigured: "No update source configured",
 					note: "Runtime updates are handled by the EDA installer",
+					sizeLabel: "Package size",
 					update: "Install runtime update",
 					updateConfirm: (version) => `Install HQ Edge runtime ${version}? HQ Edge shuts down to swap the runtime, then restarts.`,
-					updating: "Downloading and verifying the runtime bundle — this can take a minute…",
+					updating: "Downloading and verifying the runtime bundle…",
+					durationNote: "Duration depends on download speed and package size; the runtime bundle is large, and HQ Edge restarts after the swap.",
 					updateAccepted: "Runtime update accepted — HQ Edge is restarting…",
+					size: (bytes) => `~ ${formatMb(bytes)}`,
+					lastResult: {
+						title: "Last runtime update result",
+						succeeded: "Runtime update succeeded",
+						failed: "Runtime update failed",
+						rolledBack: "Runtime update rolled back (previous version restored)",
+						elevation: "A system-wide install may show a UAC elevation prompt; declining it fails the swap and rolls back to the previous version."
+					},
 					sourceHint: "Where the runtime update manifest is fetched from; saved changes take effect immediately",
 					sourceEdit: "Edit",
 					sourceSave: "Save",
@@ -618,7 +822,49 @@ window.__ModuleLoader__.load({
 				installError: "Install failed",
 				installSuccess: "Update installed — restarting DSH…",
 				confirmInstall: "Confirm install",
-				cancel: "Cancel"
+				cancel: "Cancel",
+				job: {
+					kindPluginSet: "Plugin-set update",
+					kindRuntime: "HQ Edge runtime update",
+					phase: {
+						queued: "Queued",
+						resolving: "Resolving version",
+						downloading: "Downloading",
+						verifying: "Verifying integrity",
+						staging: "Staging files",
+						activating: "Activating plugin set",
+						"awaiting-host": "Waiting for host to swap runtime",
+						restarting: "Restarting",
+						"verifying-after-restart": "Verifying after restart",
+						done: "Done",
+						failed: "Failed",
+						"rolled-back": "Rolled back",
+						abandoned: "Abandoned"
+					},
+					willRestartDsh: "DSH restarts automatically once this finishes; the update continues in the background.",
+					willSwapRuntime: "HQ Edge downloads the full runtime bundle and exits; the EDA host swaps and relaunches it. A system-wide install may show a UAC prompt.",
+					closeNote: "Closing this panel does not cancel the update.",
+					bytes: (done, total) => `${done} / ${total}`,
+					speed: (v) => `${v}/s`,
+					eta: (s) => `~${s} left`,
+					nextDone: "Finishing — please wait…",
+					resultDone: "Update completed",
+					resultFailed: "Update failed",
+					resultRolledBack: "Update rolled back",
+					resultAbandoned: "Update did not complete",
+					retry: "Retry (start a new update)",
+					recentTitle: "Recent updates",
+					stepsTitle: "Per-component progress",
+					logHint: (hint) => `Log id: ${hint}`
+				},
+				release: {
+					summaryTitle: "Release notes",
+					notesLink: "View release notes",
+					breakingTitle: "Breaking changes",
+					changesTitle: "What changed",
+					advanced: "Advanced: update sources",
+					publishedAt: (when) => `Published ${when}`
+				}
 			}
 		};
 		//#endregion
@@ -783,13 +1029,15 @@ window.__ModuleLoader__.load({
 			glyph.innerHTML = PLUGIN_ICON(24);
 			const main = el("div", "hqpu-card-main");
 			const titleRow = el("div", "hqpu-title-row");
-			const title = el("span", "hqpu-card-title", shortName(item.name));
+			const title = el("span", "hqpu-card-title", typeof item.displayName === "string" && item.displayName.trim().length > 0 ? item.displayName.trim() : shortName(item.name));
 			const tag = el("span", "hqpu-tag");
 			tag.dataset.tone = stateTone(item);
 			tag.textContent = stateLabel(item, copy);
 			titleRow.append(title, tag);
-			const desc = el("span", "hqpu-card-desc", versionLine(item));
+			const size = formatMb(item.sizeBytes ?? 0);
+			const desc = el("span", "hqpu-card-desc", size.length > 0 ? `${versionLine(item)} · ${size}` : versionLine(item));
 			main.append(titleRow, desc);
+			if (typeof item.description === "string" && item.description.trim().length > 0) main.append(el("span", "hqpu-card-desc", item.description.trim()));
 			head.append(glyph, main);
 			const end = el("div", "hqpu-card-end");
 			if (item.state === "update" || item.state === "install") {
@@ -797,6 +1045,7 @@ window.__ModuleLoader__.load({
 				button.type = "button";
 				button.disabled = installing;
 				button.innerHTML = `${DOWNLOAD_ICON(13)}<span>${copy.installOne}</span>`;
+				button.title = copy.installOneTip;
 				button.addEventListener("click", () => {
 					runInstall(store, copy);
 				});
@@ -804,9 +1053,23 @@ window.__ModuleLoader__.load({
 			}
 			head.append(end);
 			card.append(head);
+			if (Array.isArray(item.changes) && item.changes.length > 0) {
+				const expander = el("div", "hqpu-changes");
+				const toggle = el("button", "hqpu-btn hqpu-btn--ghost hqpu-btn--sm", copy.release.changesTitle);
+				toggle.type = "button";
+				const list = el("ul", "hqpu-changes-list");
+				list.style.display = "none";
+				for (const change of item.changes) if (typeof change === "string" && change.length > 0) list.append(el("li", "", change));
+				toggle.addEventListener("click", () => {
+					list.style.display = list.style.display === "none" ? "" : "none";
+				});
+				expander.append(toggle, list);
+				card.append(expander);
+			}
 			if (item.state === "blocked") {
 				const reason = blockedReason(item, copy);
 				if (reason !== void 0) card.append(el("p", "hqpu-card-reason", reason));
+				for (const entry of [...item.reasons ?? [], ...item.notes ?? []]) if (typeof entry === "string" && entry.length > 0) card.append(el("p", "hqpu-card-reason", entry));
 			}
 			return card;
 		}
@@ -859,6 +1122,220 @@ window.__ModuleLoader__.load({
 			section.setAttribute("aria-label", copy.loading);
 			return section;
 		}
+		/** Format a byte count for the progress line, or null when unknown. */
+		function formatBytes(n) {
+			if (n === void 0 || !Number.isFinite(n) || n < 0) return null;
+			if (n >= 1024 ** 3) return `${(n / 1024 ** 3).toFixed(1)} GB`;
+			if (n >= 1024 ** 2) return `${(n / 1024 ** 2).toFixed(1)} MB`;
+			if (n >= 1024) return `${(n / 1024).toFixed(0)} KB`;
+			return `${n} B`;
+		}
+		/** Format an ETA in seconds to a short human string, or null when unknown. */
+		function formatEta(seconds) {
+			if (seconds === void 0 || !Number.isFinite(seconds) || seconds <= 0) return null;
+			if (seconds < 60) return `${Math.round(seconds)} s`;
+			const minutes = Math.round(seconds / 60);
+			if (minutes < 60) return `${minutes} min`;
+			return `${Math.floor(minutes / 60)} h ${minutes % 60} min`;
+		}
+		function jobKindLabel(job, copy) {
+			return job.kind === "runtime" ? copy.job.kindRuntime : copy.job.kindPluginSet;
+		}
+		/** The phase in human words, falling back to the raw code. */
+		function phaseLabel(job, copy) {
+			return copy.job.phase[job.phase] ?? job.phase;
+		}
+		/** One per-step line for plugin-set installs (and any job that reports steps). */
+		function stepsList(job, copy) {
+			if (!Array.isArray(job.steps) || job.steps.length === 0) return null;
+			const wrap = el("div", "hqpu-job-steps");
+			wrap.append(el("p", "hqpu-group-count", copy.job.stepsTitle));
+			const ol = el("ol", "hqpu-steps");
+			for (const step of job.steps) {
+				const li = el("li", `hqpu-step hqpu-step--${step.state}`);
+				const dot = el("span", "hqpu-dot");
+				dot.dataset.state = step.state === "installed" ? "done" : step.state === "failed" ? "error" : step.state === "running" ? "warning" : "idle";
+				li.append(dot);
+				const text = step.message && step.message.length > 0 ? `${step.name} — ${step.message}` : step.name;
+				li.append(el("span", "", text));
+				ol.append(li);
+			}
+			wrap.append(ol);
+			return wrap;
+		}
+		/**
+		* The ACTIVE-JOB view: type + target, previous→target, current phase, a
+		* determinate bar only when a real percentage exists, bytes/speed/ETA when the
+		* server publishes them, and what happens next. Closing the panel never
+		* cancels the job — say so.
+		*/
+		function activeJobView(job, copy) {
+			const section = el("section", "hqpu-group");
+			section.dataset.group = "active-job";
+			const head = el("div", "hqpu-group-head");
+			const tag = el("span", "hqpu-tag");
+			tag.dataset.tone = "info";
+			tag.textContent = jobKindLabel(job, copy);
+			head.append(el("h3", "hqpu-group-title", `${jobKindLabel(job, copy)} → ${job.targetVersion}`), tag);
+			section.append(head);
+			const card = el("div", "hqpu-job");
+			const phaseLine = el("p", "hqpu-status hqpu-status--dot");
+			phaseLine.append(el("span", "hqpu-spinner"));
+			const transition = job.previousVersion !== null && job.previousVersion.length > 0 ? `${job.previousVersion} → ${job.targetVersion} · ${phaseLabel(job, copy)}` : `${job.targetVersion} · ${phaseLabel(job, copy)}`;
+			phaseLine.append(el("span", "", transition));
+			card.append(phaseLine);
+			if (typeof job.message === "string" && job.message.length > 0) card.append(el("p", "hqpu-status", job.message));
+			const pct = job.progress.percent;
+			if (pct !== null) {
+				const bar = el("div", "hqpu-progress");
+				const fill = el("div", "hqpu-progress-fill");
+				fill.style.width = `${Math.min(100, Math.max(0, pct))}%`;
+				bar.append(fill);
+				card.append(bar);
+			}
+			const bits = [];
+			if (pct !== null) bits.push(`${Math.round(pct)}%`);
+			const done = formatBytes(job.progress.bytesDone);
+			const total = formatBytes(job.progress.bytesTotal);
+			if (done !== null && total !== null) bits.push(copy.job.bytes(done, total));
+			const speed = formatBytes(job.progress.bytesPerSecond);
+			if (speed !== null) bits.push(copy.job.speed(speed));
+			const eta = formatEta(job.progress.etaSeconds);
+			if (eta !== null) bits.push(copy.job.eta(eta));
+			if (bits.length > 0) card.append(el("p", "hqpu-status hqpu-job-meta", bits.join(" · ")));
+			const steps = stepsList(job, copy);
+			if (steps !== null) card.append(steps);
+			card.append(el("p", "hqpu-status", job.kind === "runtime" ? copy.job.willSwapRuntime : copy.job.willRestartDsh));
+			card.append(el("p", "hqpu-status", copy.job.closeNote));
+			section.append(card);
+			return section;
+		}
+		/**
+		* The RESULT view for a terminal job: success / failed / rolled-back /
+		* abandoned, previous→installed, per-package steps, errorCode + message, a log
+		* correlation hint, and retry guidance (a retry starts a NEW job).
+		*/
+		function resultView(job, copy, onRetry) {
+			const section = el("section", "hqpu-group");
+			section.dataset.group = "job-result";
+			const tone = job.phase === "done" ? "success" : job.phase === "failed" ? "danger" : "warning";
+			const titleText = job.phase === "done" ? copy.job.resultDone : job.phase === "failed" ? copy.job.resultFailed : job.phase === "rolled-back" ? copy.job.resultRolledBack : copy.job.resultAbandoned;
+			const head = el("div", "hqpu-group-head");
+			const tag = el("span", "hqpu-tag");
+			tag.dataset.tone = tone;
+			tag.textContent = titleText;
+			head.append(el("h3", "hqpu-group-title", `${jobKindLabel(job, copy)} ${job.targetVersion}`), tag);
+			section.append(head);
+			const card = el("div", "hqpu-job");
+			const res = job.result;
+			const from = job.previousVersion ?? res?.installedVersion ?? "—";
+			const to = res?.installedVersion ?? job.targetVersion;
+			const finished = res !== void 0 && res.finishedAt.length > 0 ? ` · ${new Date(res.finishedAt).toLocaleString()}` : "";
+			card.append(el("p", "hqpu-status", `${from} → ${to}${finished}`));
+			if (res !== void 0 && res.message !== void 0 && res.message.length > 0) card.append(el("p", "hqpu-status", res.message));
+			if (res !== void 0 && res.errorCode !== void 0 && res.errorCode.length > 0) card.append(el("p", "hqpu-status", res.errorCode));
+			if (typeof job.logHint === "string" && job.logHint.length > 0) card.append(el("p", "hqpu-status hqpu-job-meta", copy.job.logHint(job.logHint)));
+			const steps = stepsList(job, copy);
+			if (steps !== null) card.append(steps);
+			if (job.phase === "failed" || job.phase === "abandoned") {
+				const retry = el("button", "hqpu-btn hqpu-btn--outline hqpu-btn--sm", copy.job.retry);
+				retry.type = "button";
+				retry.addEventListener("click", onRetry);
+				card.append(retry);
+			}
+			section.append(card);
+			return section;
+		}
+		/** A one-line row for older recent jobs (newest already shown as the card). */
+		function recentJobsList(jobs, copy) {
+			const older = jobs.slice(1, 5);
+			if (older.length === 0) return null;
+			const wrap = el("div", "hqpu-group");
+			wrap.dataset.group = "recent-jobs";
+			wrap.append(el("h3", "hqpu-group-count", copy.job.recentTitle));
+			const ul = el("ul", "hqpu-cards");
+			for (const job of older) {
+				const li = el("li", "hqpu-status");
+				const when = job.updatedAt.length > 0 ? ` · ${new Date(job.updatedAt).toLocaleString()}` : "";
+				li.textContent = `${jobKindLabel(job, copy)} ${job.targetVersion} · ${phaseLabel(job, copy)}${when}`;
+				ul.append(li);
+			}
+			wrap.append(ul);
+			return wrap;
+		}
+		/**
+		* Check-status banner: a FAILED check shows a clear error row + Retry (never
+		* the silent "no updates" empty state); a successful check shows the time;
+		* when a check failed but a prior report exists it is labelled stale.
+		*/
+		function checkBanner(report, copy, onRetry) {
+			const failed = typeof report.lastError === "string" && report.lastError.length > 0;
+			const checked = typeof report.checkedAt === "string" && report.checkedAt.length > 0;
+			if (!failed && !checked) return null;
+			const wrap = el("section", "hqpu-group");
+			wrap.dataset.group = "check-status";
+			if (failed) {
+				const banner = el("div", "hqpu-banner");
+				banner.dataset.tone = "danger";
+				banner.innerHTML = WARNING_ICON(14);
+				banner.append(el("span", "", copy.checkFailedBanner(report.lastError)));
+				wrap.append(banner);
+				if (report.items.length > 0) wrap.append(el("p", "hqpu-status", copy.staleNote));
+				const row = el("div", "hqpu-actions");
+				const retry = el("button", "hqpu-btn hqpu-btn--primary hqpu-btn--sm", copy.retry);
+				retry.type = "button";
+				retry.addEventListener("click", onRetry);
+				row.append(retry);
+				wrap.append(row);
+				return wrap;
+			}
+			wrap.append(el("p", "hqpu-status", copy.checkedAt(new Date(report.checkedAt).toLocaleString())));
+			return wrap;
+		}
+		/** Set-level release metadata (v2 manifest): summary, notes, breaking, link. */
+		function releaseHeader(release, copy) {
+			if (release === null || release === void 0) return null;
+			const notes = Array.isArray(release.notes) ? release.notes.filter((n) => typeof n === "string" && n.length > 0) : [];
+			const breaking = Array.isArray(release.breaking) ? release.breaking.filter((n) => typeof n === "string" && n.length > 0) : [];
+			if (!(typeof release.summary === "string" && release.summary.length > 0 || notes.length > 0 || breaking.length > 0 || typeof release.notesUrl === "string" || typeof release.publishedAt === "string")) return null;
+			const section = el("section", "hqpu-group");
+			section.dataset.group = "release";
+			section.append(el("h3", "hqpu-group-title", copy.release.summaryTitle));
+			if (typeof release.summary === "string" && release.summary.length > 0) section.append(el("p", "hqpu-status", release.summary));
+			if (typeof release.publishedAt === "string" && release.publishedAt.length > 0) section.append(el("p", "hqpu-status", copy.release.publishedAt(new Date(release.publishedAt).toLocaleString())));
+			if (release.requiresRestart === true) section.append(el("p", "hqpu-status", copy.job.willRestartDsh));
+			if (notes.length > 0) {
+				const ul = el("ul", "hqpu-release-notes");
+				for (const note of notes) ul.append(el("li", "", note));
+				section.append(ul);
+			}
+			if (breaking.length > 0) {
+				const banner = el("div", "hqpu-banner");
+				banner.dataset.tone = "danger";
+				banner.innerHTML = WARNING_ICON(14);
+				const inner = el("span");
+				inner.append(el("strong", "", `${copy.release.breakingTitle}: `));
+				inner.append(document.createTextNode(breaking.join(" · ")));
+				banner.append(inner);
+				section.append(banner);
+			}
+			if (typeof release.notesUrl === "string" && release.notesUrl.length > 0) {
+				const link = el("a", "hqpu-status hqpu-release-link", copy.release.notesLink);
+				link.href = release.notesUrl;
+				link.target = "_blank";
+				link.rel = "noreferrer";
+				section.append(link);
+			}
+			return section;
+		}
+		/** Native disclosure that hides the developer-facing source editors by
+		*  default (end users should never need to type a manifest URL). */
+		function advancedBlock(copy, nodes) {
+			const details = el("details", "hqpu-advanced");
+			details.append(el("summary", "", copy.release.advanced));
+			for (const node of nodes) if (node !== null) details.append(node);
+			return details;
+		}
 		/**
 		* Normalize the report's `runtime.source` to the full shape.
 		*
@@ -1032,13 +1509,18 @@ window.__ModuleLoader__.load({
 				else row(copy.runtime.source, copy.runtime.notConfigured);
 			} else {
 				row(copy.runtime.current, runtime.currentVersion ?? copy.runtime.unknown);
-				if (runtime.updateAvailable && latestVersion !== null) row(copy.runtime.latest, latestVersion);
+				if (runtime.updateAvailable && latestVersion !== null) {
+					row(copy.runtime.latest, latestVersion);
+					const latestEntry = runtime.latest;
+					const size = typeof latestEntry?.sizeBytes === "number" ? formatMb(latestEntry.sizeBytes) : "";
+					if (size.length > 0) row(copy.runtime.sizeLabel, size);
+				}
 				if (report.manifestVersion !== null) row(copy.runtime.set, report.manifestVersion, true);
 				if (typeof runtime.checkedAt === "string" && runtime.checkedAt.length > 0) row(copy.runtime.checkedAt, new Date(runtime.checkedAt).toLocaleString());
 				if (source !== null) sourceFactRow(facts, source, copy);
 			}
 			section.append(facts);
-			if (source !== null) section.append(sourceEditor("runtime", source, copy, actions));
+			if (source !== null) section.append(advancedBlock(copy, [sourceEditor("runtime", source, copy, actions)]));
 			if (runtime.updateAvailable && latestVersion !== null) {
 				const row = el("div", "hqpu-actions hqpu-runtime-actions");
 				if (actions.accepted) {
@@ -1070,7 +1552,25 @@ window.__ModuleLoader__.load({
 					row.append(start);
 				}
 				section.append(row);
+				section.append(el("p", "hqpu-status hqpu-job-meta", copy.runtime.durationNote));
 			} else section.append(el("p", "hqpu-status", copy.runtime.note));
+			const lastResult = runtime.lastResult;
+			if (lastResult !== null && lastResult !== void 0) {
+				const state = lastResult.state;
+				const line = el("p", "hqpu-status hqpu-status--dot");
+				line.setAttribute("role", "status");
+				const dot = el("span", "hqpu-dot");
+				dot.dataset.state = state === "succeeded" ? "done" : state === "failed" ? "error" : "warning";
+				const parts = [state === "succeeded" ? copy.runtime.lastResult.succeeded : state === "failed" ? copy.runtime.lastResult.failed : copy.runtime.lastResult.rolledBack];
+				if (lastResult.targetVersion) parts.push(`→ ${lastResult.targetVersion}`);
+				if (lastResult.installedVersion) parts.push(`(${lastResult.installedVersion})`);
+				if (lastResult.at) parts.push(new Date(lastResult.at).toLocaleString());
+				line.append(dot, el("span", "", parts.join(" ")));
+				section.append(line);
+				if (typeof lastResult.message === "string" && lastResult.message.length > 0) section.append(el("p", "hqpu-status", lastResult.message));
+				if (typeof lastResult.errorCode === "string" && lastResult.errorCode.length > 0) section.append(el("p", "hqpu-status hqpu-job-meta", lastResult.errorCode));
+				if (state !== "succeeded") section.append(el("p", "hqpu-status hqpu-job-meta", copy.runtime.lastResult.elevation));
+			}
 			if (typeof runtime.lastError === "string" && runtime.lastError.length > 0) {
 				const line = el("p", "hqpu-status hqpu-status--dot");
 				line.setAttribute("role", "status");
@@ -1081,14 +1581,18 @@ window.__ModuleLoader__.load({
 			}
 			return section;
 		}
-		function renderList(section, report, copy, installing, store) {
+		function renderList(section, report, copy, installing, store, onRetryCheck) {
 			section.textContent = "";
 			if (report === null) {
 				section.append(skeleton(copy));
 				return;
 			}
+			const banner = checkBanner(report, copy, onRetryCheck);
+			if (banner !== null) section.append(banner);
+			const release = releaseHeader(report.release, copy);
+			if (release !== null) section.append(release);
 			if (report.items.length === 0) {
-				section.append(el("div", "hqpu-empty", copy.empty));
+				if (typeof report.lastError !== "string" || report.lastError.length === 0) section.append(el("div", "hqpu-empty", copy.empty));
 				return;
 			}
 			const byState = (state) => report.items.filter((item) => item.state === state);
@@ -1108,14 +1612,16 @@ window.__ModuleLoader__.load({
 			if (report === null) return;
 			section.append(runtimeGroup(report, copy, actions));
 		}
-		/** The plugin-source group, above the plugin groups. No-op without the field. */
+		/** The plugin-source group, above the plugin groups, hidden behind an advanced
+		*  disclosure (manifest-URL editing is a developer affordance). No-op without
+		*  the field. */
 		function renderPluginSource(section, report, copy, actions) {
 			section.textContent = "";
 			if (report === null) return;
 			const node = pluginSourceGroup(report, copy, actions);
-			if (node !== null) section.append(node);
+			if (node !== null) section.append(advancedBlock(copy, [node]));
 		}
-		/** Run the install transaction, then keep polling until the state settles. */
+		/** Run the install transaction (a new durable job), then let the store poll it. */
 		async function runInstall(store, copy) {
 			const report = store.report();
 			if (report === null) return;
@@ -1123,15 +1629,18 @@ window.__ModuleLoader__.load({
 				showToast(copy.checkFailed, "error");
 				return;
 			}
+			store.setInstalling(true);
 			try {
 				const result = await installSet(report.manifestVersion);
 				if (result.error !== void 0) {
+					store.setInstalling(false);
 					showToast(`${copy.installError}: ${result.error}`, "error");
 					return;
 				}
 				showToast(copy.installSuccess, "success");
-				pollUntilSettled(store);
+				store.fetchStatus();
 			} catch (err) {
+				store.setInstalling(false);
 				showToast(`${copy.installError}: ${err instanceof Error ? err.message : String(err)}`, "error");
 			}
 		}
@@ -1194,22 +1703,6 @@ window.__ModuleLoader__.load({
 				bar.append(ignore);
 			}
 		}
-		/** After an install, poll the backend until the update report settles
-		*  (installing flag clears or DSH restarts under us — the next load re-reads
-		*  the fresh state). */
-		function pollUntilSettled(store) {
-			let attempts = 0;
-			const tick = () => {
-				store.refresh().then((report) => {
-					if (store.installing()) return;
-					if (report !== null && report.ignoredSet === false && attempts >= 2) return;
-				}).catch(() => void 0).finally(() => {
-					attempts += 1;
-					if (attempts < 10) window.setTimeout(tick, 2e3);
-				});
-			};
-			tick();
-		}
 		/**
 		* Open (or focus) the update panel. Re-renders from the store; when the store
 		* is stale the panel first refreshes the report.
@@ -1256,11 +1749,12 @@ window.__ModuleLoader__.load({
 			panel.append(head);
 			const scroll = el("div", "hqpu-scroll");
 			const column = el("div", "hqpu-column");
+			const jobSection = el("div", "hqpu-stack");
 			const pluginSourceSection = el("div", "hqpu-stack");
 			const listSection = el("div", "hqpu-stack");
 			const runtimeSection = el("div", "hqpu-stack");
 			const toastSection = el("div", "hqpu-toast-host");
-			column.append(pluginSourceSection, listSection, runtimeSection, toastSection);
+			column.append(jobSection, pluginSourceSection, listSection, runtimeSection, toastSection);
 			scroll.append(column);
 			panel.append(scroll);
 			const footer = el("div", "hqpu-footer");
@@ -1403,6 +1897,7 @@ window.__ModuleLoader__.load({
 					}
 					runtimeAccepted = true;
 					showToast(copy.runtime.updateAccepted, "success");
+					store.fetchStatus();
 				} catch (err) {
 					showToast(`${copy.installError}: ${err instanceof Error ? err.message : String(err)}`, "error");
 				} finally {
@@ -1410,15 +1905,43 @@ window.__ModuleLoader__.load({
 					render();
 				}
 			}
+			/** Retry a failed/abandoned job: plugin-set → a fresh install; runtime →
+			*  re-arm the runtime confirm flow. Always a NEW job, never re-clicking the
+			*  settled job id. */
+			const retryJob = (kind) => {
+				if (kind === "runtime") {
+					runtimeArmed = true;
+					render();
+				} else runInstall(store, copy);
+			};
+			const renderJobSection = () => {
+				jobSection.textContent = "";
+				const active = store.activeJob();
+				if (active !== null && !TERMINAL_PHASES.has(active.phase)) {
+					jobSection.append(activeJobView(active, copy));
+					return;
+				}
+				const recent = store.recentJobs();
+				const latest = recent[0];
+				if (latest !== void 0 && TERMINAL_PHASES.has(latest.phase)) {
+					jobSection.append(resultView(latest, copy, () => retryJob(latest.kind)));
+					const older = recentJobsList(recent, copy);
+					if (older !== null) jobSection.append(older);
+				}
+			};
 			const render = () => {
 				const report = store.report();
-				const installing = store.installing();
+				const jobActive = store.activeJob() !== null && !TERMINAL_PHASES.has(store.activeJob().phase);
+				const installing = store.installing() || jobActive;
 				const stale = report === null;
 				refreshBtn.disabled = stale;
+				renderJobSection();
 				if (stale) {
 					listSection.textContent = "";
 					listSection.append(skeleton(copy));
-				} else renderList(listSection, report, copy, installing, store);
+				} else renderList(listSection, report, copy, installing, store, () => {
+					store.check();
+				});
 				renderPluginSource(pluginSourceSection, report, copy, pluginActions);
 				renderRuntime(runtimeSection, report, copy, runtimeActions);
 				renderActions(actionBar, report, copy, store, installing);
@@ -2202,6 +2725,97 @@ window.__ModuleLoader__.load({
   padding: 0 24px 20px;
 }
 
+/* ── Durable job (active / result) ────────────────────────────────────── */
+.hqpu-job {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 12px;
+  border: 0.5px solid var(--dsw-alias-border-l2);
+  border-radius: var(--dsw-radius-lg);
+  background: var(--dsw-alias-bg-layer-3);
+}
+.hqpu-job-meta {
+  font-variant-numeric: tabular-nums;
+}
+.hqpu-progress {
+  height: 6px;
+  border-radius: 999px;
+  background: var(--dsw-alias-bg-module-platform);
+  overflow: hidden;
+}
+.hqpu-progress-fill {
+  height: 100%;
+  border-radius: 999px;
+  background: var(--dsw-alias-state-business-primary);
+  transition: width var(--ds-transition-duration, 0.2s) ease;
+}
+.hqpu-job-steps {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+.hqpu-steps {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+.hqpu-step {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  font-size: 12.5px;
+  line-height: 18px;
+  color: var(--dsw-alias-label-secondary);
+}
+.hqpu-step--skipped,
+.hqpu-step--pending { opacity: 0.6; }
+
+/* ── Per-plugin change list + release notes ────────────────────────────── */
+.hqpu-changes {
+  padding: 0 8px 8px 70px;
+}
+.hqpu-changes-list,
+.hqpu-release-notes {
+  margin: 4px 0 0;
+  padding-left: 18px;
+  font-size: 12.5px;
+  line-height: 19px;
+  color: var(--dsw-alias-label-secondary);
+}
+.hqpu-release-link {
+  align-self: flex-start;
+}
+
+/* ── Advanced disclosure (source editors) ───────────────────────────────── */
+.hqpu-advanced > summary {
+  cursor: pointer;
+  font-size: 12.5px;
+  line-height: 20px;
+  color: var(--dsw-alias-label-tertiary);
+  list-style: none;
+  padding: 2px 0;
+}
+.hqpu-advanced > summary::-webkit-details-marker { display: none; }
+.hqpu-advanced > summary::before {
+  content: '▸ ';
+}
+.hqpu-advanced[open] > summary::before {
+  content: '▾ ';
+}
+
+/* Danger-toned banner (check failure, breaking changes) */
+.hqpu-banner[data-tone='danger'] {
+  background: color-mix(in srgb, var(--dsw-alias-state-error-primary) 8%, transparent);
+  color: var(--dsw-alias-label-secondary);
+}
+.hqpu-banner[data-tone='danger'] > svg {
+  color: var(--dsw-alias-state-error-primary);
+}
+
 .hqpu-visually-hidden {
   position: absolute;
   width: 1px;
@@ -2346,33 +2960,114 @@ window.__ModuleLoader__.load({
 		var UpdateStore = class {
 			current = null;
 			installingFlag = false;
+			/** The durable job the server currently reports as active (resumed across
+			*  panel close and DSH restart); null when idle. */
+			active = null;
+			recent = [];
 			listeners = /* @__PURE__ */ new Set();
 			refreshTimer = null;
+			pollTimer = null;
+			pollBackoffMs = 1e3;
+			pollInFlight = false;
 			report() {
 				return this.current;
 			}
 			installing() {
 				return this.installingFlag;
 			}
+			activeJob() {
+				return this.active;
+			}
+			recentJobs() {
+				return [...this.recent];
+			}
 			subscribe(listener) {
 				this.listeners.add(listener);
 				return () => {
 					this.listeners.delete(listener);
 				};
 			}
-			/** Badge count per spec §6.3: actionable `update` + `install`, excluding the
-			*  ignored offer (the server already folds ignore into item states; keep the
-			*  client-side filter as a defensive second pass). */
+			/**
+			* Badge: counts actionable plugin updates AND an available runtime update AND
+			* (while a job runs) an attention pill. A recent failed/rolled-back job with
+			* nothing actionable left also keeps a dot, so the outcome is never silently
+			* forgotten after the panel closes.
+			*/
 			badgeCount() {
+				const job = this.active;
+				if (job !== null && !TERMINAL_PHASES.has(job.phase)) return 1;
 				const report = this.current;
 				if (report === null) return 0;
-				return report.items.filter((item) => item.state === "update" || item.state === "install").length;
+				let count = report.items.filter((item) => item.state === "update" || item.state === "install").length;
+				if (report.runtime?.updateAvailable) count += 1;
+				if (count === 0) {
+					const latest = this.recent[0];
+					if (latest !== void 0 && (latest.phase === "failed" || latest.phase === "rolled-back")) count = 1;
+				}
+				return count;
 			}
 			emit() {
 				for (const listener of [...this.listeners]) try {
 					listener();
 				} catch {}
 			}
+			/** Adopt a fresh `/status` snapshot and (re)arm the poll loop. */
+			applyStatus(status) {
+				const wasActive = this.active !== null;
+				this.active = status.activeJob;
+				this.recent = status.recentJobs;
+				if (wasActive && this.active === null) this.installingFlag = false;
+				this.emit();
+				this.schedulePoll();
+			}
+			/**
+			* Fetch the durable job status. Called on mount, on panel open (BEFORE
+			* discovery) and by the poll loop. A failure (older hq-edge with no
+			* `/status`, or a transient HTTP error) is swallowed: the last known job is
+			* kept and the poller backs off and retries.
+			*/
+			async fetchStatus() {
+				try {
+					const status = await fetchJobStatus();
+					this.pollBackoffMs = 1e3;
+					this.applyStatus(status);
+				} catch {
+					this.schedulePoll();
+				}
+			}
+			/** ~1 s poll while a job is active; stop on terminal; back off on error
+			*  without discarding the last known job; never overlap requests. */
+			schedulePoll() {
+				if (this.pollTimer !== null) {
+					window.clearTimeout(this.pollTimer);
+					this.pollTimer = null;
+				}
+				const job = this.active;
+				if (job === null || TERMINAL_PHASES.has(job.phase)) {
+					this.pollBackoffMs = 1e3;
+					return;
+				}
+				this.pollTimer = window.setTimeout(() => {
+					this.pollTick();
+				}, this.pollBackoffMs);
+			}
+			async pollTick() {
+				if (this.pollInFlight) {
+					this.schedulePoll();
+					return;
+				}
+				this.pollInFlight = true;
+				try {
+					const status = await fetchJobStatus();
+					this.pollBackoffMs = 1e3;
+					this.applyStatus(status);
+				} catch {
+					this.pollBackoffMs = Math.min(5e3, Math.max(1e3, this.pollBackoffMs * 2));
+					this.schedulePoll();
+				} finally {
+					this.pollInFlight = false;
+				}
+			}
 			async refresh() {
 				try {
 					const report = await fetchReport();
@@ -2410,6 +3105,10 @@ window.__ModuleLoader__.load({
 					window.clearInterval(this.refreshTimer);
 					this.refreshTimer = null;
 				}
+				if (this.pollTimer !== null) {
+					window.clearTimeout(this.pollTimer);
+					this.pollTimer = null;
+				}
 				this.listeners.clear();
 			}
 		};
@@ -2450,9 +3149,23 @@ window.__ModuleLoader__.load({
 			});
 			const openView = () => {
 				ensureDesignTokens();
-				store.check().then((report) => {
-					if (report !== null) openUpdateView(store, copyFor());
-				});
+				store.fetchStatus();
+				openUpdateView(store, copyFor());
+				store.check();
+			};
+			const statusLabel = () => {
+				const base = entryCopy(locale);
+				const job = store.activeJob();
+				if (job !== null) {
+					const cc = copyFor();
+					const pct = job.progress.percent;
+					const phase = cc.job.phase[job.phase] ?? job.phase;
+					return {
+						label: pct !== null ? `${base.label} · ${Math.round(pct)}%` : `${base.label} · ${phase}`,
+						tooltip: `${base.tooltip} · ${phase}`
+					};
+				}
+				return base;
 			};
 			const disposeEntry = mountSidebarEntry({
 				rowAttribute: UPDATE_ENTRY_ATTRIBUTE,
@@ -2460,8 +3173,8 @@ window.__ModuleLoader__.load({
 				plugin: PLUGIN_ID,
 				icon: UPDATE_ICON,
 				css: ENTRY_CSS,
-				label: () => entryCopy(locale).label,
-				tooltip: () => entryCopy(locale).tooltip,
+				label: () => statusLabel().label,
+				tooltip: () => statusLabel().tooltip,
 				refresh: { subscribe: refreshSubscribe },
 				badge: {
 					subscribe: (listener) => store.subscribe(listener),
@@ -2471,8 +3184,14 @@ window.__ModuleLoader__.load({
 				position: "after",
 				familySelectors: HUAQIU_SIDEBAR_ENTRY_FAMILY
 			});
+			store.subscribe(() => {
+				for (const fn of [...localeSubscribers]) try {
+					fn();
+				} catch {}
+			});
 			store.startIdleRefresh();
 			store.refresh();
+			store.fetchStatus();
 			const dispose = () => {
 				try {
 					disposeEntry();