@linxin666/dsh-client-ui-task-board 0.3.19 → 0.3.21

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   node scripts/verify-docs.mjs --write <dir>
-README.md: eda801f7c7e9b6811eabe5f710ef87308ab6d9ed
-README.zh.md: 61cbdb083679dae12edb35f658531386094767db
+README.md: dfc7909337ae3a340e6330b175f8e275b082c4bc
+README.zh.md: deb74cbc58f4fb06e08fe7b2544ebc9f7e489d10

package/README.md

@@ -27,6 +27,8 @@ A hot-pluggable DeepSeek Harness (DSH) Web GUI plugin with a Host-authoritative
 
 ## Architecture and protocol
 
+The board view renders on first open and keeps its local view state when closed and reopened. Host synchronization, scheduling and execution remain active independently of the view.
+
 - `src/index.ts` mounts the Host service through the official `@deepseek-ai/dsh-api-gateway`, `@deepseek-ai/dsh-workspace`, and `@deepseek-ai/dsh-host-webserver` SDKs.
 - `src/host-ledger.ts` serializes actions and persists `{ schemaVersion: 3, revision, tasks, scheduler, recentRequests }` through a temporary file plus atomic rename.
 - `src/host-service.ts` owns cron ticks, missed-trigger skipping, runner launch, restart reconciliation, and power reasons.

package/README.zh.md

@@ -27,6 +27,8 @@
 
 ## 架构与协议
 
+看板视图在首次打开时渲染，关闭后重新打开会保留本地视图状态。Host 同步、调度和执行独立于视图持续运行。
+
 - `src/index.ts` 通过官方 `@deepseek-ai/dsh-api-gateway`、`@deepseek-ai/dsh-workspace` 与 `@deepseek-ai/dsh-host-webserver` SDK 挂载 Host 服务。
 - `src/host-ledger.ts` 串行动作，并用临时文件加原子 rename 持久化 `{ schemaVersion: 3, revision, tasks, scheduler, recentRequests }`。
 - `src/host-service.ts` 负责 cron tick、错过触发跳过、runner 启动、重启对账和电源保护理由。

package/lib/client.js

@@ -8,8 +8,18 @@ window.__ModuleLoader__.load({
 		let react_jsx_runtime = require("react/jsx-runtime");
 		let react_dom_client = require("react-dom/client");
 		//#region src/core/tasks.ts
-		/** Statuses a settled task may be archived from. */
-		const ARCHIVABLE_STATUSES = ["done", "failed"];
+		/**
+		* Statuses a task may be archived from: every status but `running`, whose
+		* execution the runner still owns until it settles. A settled-only gate made
+		* the duplicate-and-archive flow a silent no-op for scheduled tasks, which
+		* return to `todo` after every successful run (issue #1447).
+		*/
+		const ARCHIVABLE_STATUSES = [
+			"backlog",
+			"todo",
+			"done",
+			"failed"
+		];
 		/** Permission presets a task may pin on its execution session (the `/permission <id>` ids). */
 		const TASK_PERMISSIONS = [
 			"read-only",
@@ -145,10 +155,10 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/core/use-cases/task-archive.ts
 		/**
-		* Archive one task: only settled statuses (done/failed) can be archived;
-		* a running or not-yet-settled task stays on the board (its runner still
-		* owns its lifecycle). Archiving disarms a schedule; already-archived tasks
-		* are a no-op.
+		* Archive one task: only a `running` task stays on the board (its runner
+		* still owns its lifecycle until the execution settles); every other status
+		* can be archived. Archiving disarms a schedule; already-archived tasks are
+		* a no-op.
 		*/
 		function applyArchiveTask(tasks, id, now) {
 			let applied = false;
@@ -338,7 +348,7 @@ window.__ModuleLoader__.load({
 					high = Number(b);
 				} else if (isDigits(range)) {
 					low = Number(range);
-					high = Number(range);
+					high = stepRaw === void 0 ? low : max;
 				} else return false;
 				if (low < min || high > max || low > high) return false;
 				const step = stepRaw === void 0 ? 1 : isDigits(stepRaw) ? Number(stepRaw) : NaN;
@@ -751,9 +761,8 @@ window.__ModuleLoader__.load({
 				this.persistAndNotify();
 			}
 			/**
-			* Archive a settled task (done/failed). Running or on-board-unsettled
-			* tasks are refused so the runner keeps exclusive ownership of their
-			* lifecycle.
+			* Archive a task from any status but `running`, whose lifecycle the runner
+			* keeps exclusive ownership of until it settles.
 			* @returns true when applied.
 			*/
 			archiveTask(id) {
@@ -3015,10 +3024,10 @@ window.__ModuleLoader__.load({
 											}),
 											/* @__PURE__ */ (0, react_jsx_runtime.jsx)("ul", {
 												className: board_module_css_default.executionList,
-												children: current.handover.references.map((reference) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", {
+												children: current.handover.references.map((reference, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", {
 													className: board_module_css_default.executionRow,
 													children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", { children: reference })
-												}, reference))
+												}, `${reference}-${index}`))
 											}),
 											/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 												className: board_module_css_default.detailMeta,
@@ -3414,6 +3423,94 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
+		//#region src/client/body-mutations.ts
+		/** Cross-bundle registry key; `Symbol.for` so every module copy agrees. */
+		const HUB_KEY = Symbol.for("dsh-web.body-mutation-hub");
+		const INVALIDATION_ONLY = Symbol.for("dsh-web.body-mutation-invalidation");
+		function needsRecords(subscribers) {
+			for (const listener of subscribers) if (!listener[INVALIDATION_ONLY]) return true;
+			return false;
+		}
+		/**
+		* Subscribe to a coalesced DOM re-check without retaining mutation records.
+		* The marked wrapper also works with an older hub, which delivers records
+		* that it simply ignores until a page reload picks up the updated hub.
+		*/
+		function subscribeBodyInvalidations(subscriber) {
+			const listener = () => {
+				subscriber();
+			};
+			listener[INVALIDATION_ONLY] = true;
+			return subscribeBodyMutations(listener);
+		}
+		/**
+		* Subscribe to body-level childList mutations.
+		* @param subscriber - called at most once per animation frame with the records
+		*   collected since the previous flush; must be safe to run repeatedly.
+		* @returns the disposer removing this subscriber (and the observer when it was
+		*   the last one).
+		*/
+		function subscribeBodyMutations(subscriber) {
+			if (typeof globalThis === "undefined" || typeof document === "undefined") return () => {};
+			if (typeof MutationObserver !== "function") return () => {};
+			const registry = globalThis;
+			let hub = registry[HUB_KEY];
+			if (hub === void 0) {
+				const subscribers = /* @__PURE__ */ new Set();
+				const created = {
+					observer: void 0,
+					subscribers,
+					pending: [],
+					scheduled: false
+				};
+				const flush = () => {
+					created.frame = void 0;
+					created.scheduled = false;
+					const batch = created.pending;
+					created.pending = [];
+					for (const listener of [...subscribers]) {
+						if (!subscribers.has(listener)) continue;
+						try {
+							listener(batch);
+						} catch {}
+					}
+				};
+				const schedule = () => {
+					if (created.scheduled) return;
+					created.scheduled = true;
+					if (typeof requestAnimationFrame === "function") created.frame = requestAnimationFrame(flush);
+					else flush();
+				};
+				created.observer = new MutationObserver((records) => {
+					if (needsRecords(subscribers)) for (const record of records) created.pending.push(record);
+					schedule();
+				});
+				created.observer.observe(document.body ?? document.documentElement, {
+					childList: true,
+					subtree: true
+				});
+				registry[HUB_KEY] = created;
+				hub = created;
+			}
+			const active = hub;
+			active.subscribers.add(subscriber);
+			let subscribed = true;
+			return () => {
+				if (!subscribed) return;
+				subscribed = false;
+				active.subscribers.delete(subscriber);
+				if (!needsRecords(active.subscribers)) active.pending = [];
+				if (active.subscribers.size === 0 && registry[HUB_KEY] === active) {
+					active.observer.disconnect();
+					if (active.frame !== void 0 && typeof cancelAnimationFrame === "function") cancelAnimationFrame(active.frame);
+					active.frame = void 0;
+					active.pending = [];
+					active.scheduled = false;
+					delete registry[HUB_KEY];
+				}
+			};
+		}
+		//#endregion
 		//#region src/client/panel-mount-core.ts
 		/**
 		* Center-column panel takeover lifecycle.
@@ -3458,32 +3555,31 @@ window.__ModuleLoader__.load({
 				});
 			} catch {}
 			const ensure = () => {
-				if (container !== void 0) {
-					if (container.isConnected) return;
+				if (container !== void 0 && !container.isConnected) {
 					root?.unmount();
 					root = void 0;
 					container.remove();
 					container = void 0;
 				}
-				const column = conversationColumn();
-				if (column === void 0) return;
-				container = document.createElement("div");
-				container.dataset[options.viewDatasetKey] = "";
-				container.dataset.dshPlugin = options.pluginName;
-				container.className = options.viewClassName;
-				column.appendChild(container);
+				if (container === void 0) {
+					const column = conversationColumn();
+					if (column === void 0) return;
+					container = document.createElement("div");
+					container.dataset[options.viewDatasetKey] = "";
+					container.dataset.dshPlugin = options.pluginName;
+					container.className = options.viewClassName;
+					column.appendChild(container);
+				}
+				if (root !== void 0 || !options.isOpen()) return;
 				root = (0, react_dom_client.createRoot)(container);
 				options.render(root);
 			};
-			const waitObserver = new MutationObserver(() => {
+			const unsubscribeBody = subscribeBodyInvalidations(() => {
 				ensure();
 			});
-			waitObserver.observe(document.body, {
-				childList: true,
-				subtree: true
-			});
 			const applyActive = () => {
 				if (options.isOpen()) {
+					ensure();
 					document.documentElement.removeAttribute(options.siblingActiveAttribute);
 					document.documentElement.setAttribute(options.activeAttribute, "");
 					document.dispatchEvent(new CustomEvent(ACTIVATE_EVENT, { detail: options.panelName }));
@@ -3506,7 +3602,7 @@ window.__ModuleLoader__.load({
 			return () => {
 				document.removeEventListener("click", onClickSidebarRow, true);
 				document.removeEventListener(ACTIVATE_EVENT, onOtherActivate);
-				waitObserver.disconnect();
+				unsubscribeBody();
 				unsubscribe();
 				unsubscribeLocale?.();
 				document.documentElement.removeAttribute(options.activeAttribute);
@@ -3544,6 +3640,21 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/client/sidebar-entry-core.ts
+		/**
+		* Shared sidebar entry injection core.
+		*
+		* dsh's sidebar shell exposes no slot an external plugin can register into,
+		* so the entry row is injected between the shell's New Session button and the
+		* workspace browser. The injection self-heals: a MutationObserver watches the
+		* sidebar root and re-inserts the row whenever a React re-render displaces it
+		* (re-insertion happens in the same frame, before paint, so no flicker).
+		*
+		* The row is plain DOM (no React tree) so it can never disturb the shell's
+		* reconciliation; the view it toggles is a separate root owned by the caller.
+		*
+		* Packages receive this file as a generated copy via scripts/sync-shared.mjs;
+		* edit the shared source and re-run the sync instead of editing a copy.
+		*/
 		/** Find the sidebar shell root element, or undefined while not yet mounted. */
 		function sidebarRoot() {
 			const column = document.querySelector("[data-pane=\"sidebar\"], [class*=\"sidebarCol\"]");
@@ -3632,13 +3743,9 @@ window.__ModuleLoader__.load({
 					subtree: true
 				});
 			};
-			const waitObserver = new MutationObserver(() => {
+			const unsubscribeBody = subscribeBodyInvalidations(() => {
 				tryPlace();
 			});
-			waitObserver.observe(document.body, {
-				childList: true,
-				subtree: true
-			});
 			const rootObserver = new MutationObserver(() => {
 				if (root === void 0 || !root.isConnected) {
 					placed = false;
@@ -3658,7 +3765,7 @@ window.__ModuleLoader__.load({
 			})();
 			tryPlace();
 			return () => {
-				waitObserver.disconnect();
+				unsubscribeBody();
 				rootObserver.disconnect();
 				unsubscribeRefresh?.();
 				unsubscribeActive?.();
@@ -4636,7 +4743,7 @@ window.__ModuleLoader__.load({
 		/** The building package's version, when the bundle carries it. */
 		function bakedVersion() {
 			try {
-				return "0.3.19";
+				return "0.3.21";
 			} catch {
 				return;
 			}
@@ -4719,7 +4826,8 @@ window.__ModuleLoader__.load({
 			"connection",
 			"settingsScope",
 			"locale",
-			"remote"
+			"remote",
+			"remote.session"
 		];
 		/**
 		* Mount the task board.
@@ -4766,7 +4874,7 @@ window.__ModuleLoader__.load({
 				if (uiDisposer !== void 0) return;
 				const sessions = ctx.get("sessions");
 				const workspaces = ctx.get("workspaces");
-				ctx.get("remote");
+				const remote = ctx.get("remote");
 				const controller = new BoardController({
 					store: new LocalStorageTaskStore(),
 					transport: new HttpTaskBoardHostTransport(),
@@ -4788,29 +4896,55 @@ window.__ModuleLoader__.load({
 				disposers.push(workspaces.list.subscribe(pushWorkspaceOptions));
 				const pushModelOptions = async () => {
 					try {
-						const conn = ctx.get("connection");
-						if (conn?.api) {
-							let models = [];
-							if (typeof conn.api.llm?.discoverModels === "function") {
-								const list = (await conn.api.llm.discoverModels())?.result?.value?.models;
-								if (Array.isArray(list)) models = list.map((m) => ({
-									id: m.id,
-									name: m.name
-								}));
-							}
-							if (models.length === 0 && typeof conn.api.sessions?.modelCatalog === "function") {
-								const groups = (await conn.api.sessions.modelCatalog())?.result?.value?.groups;
-								if (Array.isArray(groups)) for (const g of groups) for (const m of g.models ?? []) {
-									const qualifiedId = g.provider ? `${g.provider}/${m.id}` : m.id;
+						let models = [];
+						let sessionRemote;
+						try {
+							sessionRemote = remote.session;
+						} catch {
+							sessionRemote = void 0;
+						}
+						if (typeof sessionRemote?.modelCatalog === "function") {
+							const res = await sessionRemote.modelCatalog();
+							if (res.ok && Array.isArray(res.value?.groups)) for (const g of res.value.groups) {
+								const provider = g.id ?? g.provider;
+								for (const m of g.models ?? []) {
+									const qualifiedId = provider ? `${provider}/${m.id}` : m.id;
 									models.push({
 										id: qualifiedId,
 										name: m.name ?? m.id,
-										provider: g.provider
+										provider
 									});
 								}
 							}
-							if (models.length > 0) controller.setExecutionOptions({ models });
 						}
+						if (models.length === 0) {
+							const conn = ctx.get("connection");
+							if (conn?.api) {
+								if (typeof conn.api.llm?.discoverModels === "function") {
+									const list = (await conn.api.llm.discoverModels())?.result?.value?.models;
+									if (Array.isArray(list)) models = list.map((m) => ({
+										id: m.id,
+										name: m.name
+									}));
+								}
+								const catalogFn = typeof conn.api.session?.modelCatalog === "function" ? conn.api.session.modelCatalog : typeof conn.api.sessions?.modelCatalog === "function" ? conn.api.sessions.modelCatalog : void 0;
+								if (models.length === 0 && catalogFn !== void 0) {
+									const groups = (await catalogFn())?.result?.value?.groups;
+									if (Array.isArray(groups)) for (const g of groups) {
+										const provider = g.id ?? g.provider;
+										for (const m of g.models ?? []) {
+											const qualifiedId = provider ? `${provider}/${m.id}` : m.id;
+											models.push({
+												id: qualifiedId,
+												name: m.name ?? m.id,
+												provider
+											});
+										}
+									}
+								}
+							}
+						}
+						if (models.length > 0) controller.setExecutionOptions({ models });
 					} catch (error) {
 						console.error("[dsh-task-board] model options read failed", error);
 					}