dsh-taskboard 0.4.5 → 0.5.1

package/lib/client.js

@@ -18,20 +18,26 @@ window.__ModuleLoader__.load({
 			if (!body.ok) throw new Error(`taskboard: ${body.error.code}: ${body.error.message}`);
 			return body.value;
 		}
+		/** Request timeout (S15: a hung fetch must never pin refreshInFlight forever). */
+		const TIMEOUT_MS = 1e4;
+		async function get(path) {
+			return unwrap(fetch(path, { signal: AbortSignal.timeout(TIMEOUT_MS) }));
+		}
 		async function post(path, body) {
 			return unwrap(await fetch(path, {
 				method: "POST",
 				headers: { "content-type": "application/json" },
-				body: JSON.stringify(body)
+				body: JSON.stringify(body),
+				signal: AbortSignal.timeout(TIMEOUT_MS)
 			}));
 		}
 		/** Build the client over fetch + EventSource. */
 		function createClient() {
 			return {
-				state: () => unwrap(fetch("/dsh-taskboard/state")),
-				workspaces: () => unwrap(fetch("/dsh-taskboard/workspaces")),
+				state: () => get("/dsh-taskboard/state"),
+				workspaces: () => get("/dsh-taskboard/workspaces"),
 				create: (body) => post("/dsh-taskboard/tasks", body),
-				get: (id) => unwrap(fetch(`/dsh-taskboard/tasks/${encodeURIComponent(id)}`)),
+				get: (id) => get(`/dsh-taskboard/tasks/${encodeURIComponent(id)}`),
 				update: (id, body) => post(`/dsh-taskboard/tasks/${encodeURIComponent(id)}/update`, body),
 				move: (id, body) => post(`/dsh-taskboard/tasks/${encodeURIComponent(id)}/move`, body),
 				reject: (id, body) => post(`/dsh-taskboard/tasks/${encodeURIComponent(id)}/reject`, body),
@@ -41,7 +47,7 @@ window.__ModuleLoader__.load({
 				cancel: (id) => post(`/dsh-taskboard/tasks/${encodeURIComponent(id)}/cancel`, {}),
 				mergeBranch: (id) => post(`/dsh-taskboard/tasks/${encodeURIComponent(id)}/merge`, {}),
 				worktreeRemove: (id, body) => post(`/dsh-taskboard/tasks/${encodeURIComponent(id)}/worktree-remove`, body),
-				diagnostics: () => unwrap(fetch("/dsh-taskboard/diagnostics")),
+				diagnostics: () => get("/dsh-taskboard/diagnostics"),
 				worktreeCleanup: (workspaceId, taskId) => post("/dsh-taskboard/worktree-cleanup", {
 					workspaceId,
 					taskId
@@ -50,26 +56,38 @@ window.__ModuleLoader__.load({
 					const params = new URLSearchParams({ execution: query.execution });
 					if (query.commit !== void 0) params.set("commit", query.commit);
 					if (query.path !== void 0) params.set("path", query.path);
-					return unwrap(fetch(`/dsh-taskboard/tasks/${encodeURIComponent(taskId)}/diff?${params.toString()}`));
+					return get(`/dsh-taskboard/tasks/${encodeURIComponent(taskId)}/diff?${params.toString()}`);
 				},
 				importPreview: (file) => post("/dsh-taskboard/import/preview", file),
 				importCommit: (mode, ledger) => post("/dsh-taskboard/import", {
 					mode,
 					ledger
 				}),
-				templates: () => unwrap(fetch("/dsh-taskboard/templates")),
+				templates: () => get("/dsh-taskboard/templates"),
 				templateUpsert: (body) => post("/dsh-taskboard/templates", body),
 				templateDelete: (id) => post("/dsh-taskboard/templates/delete", { id }),
+				settings: () => get("/dsh-taskboard/settings"),
+				updateSettings: (body) => post("/dsh-taskboard/settings/update", body),
 				stream(onChange, onGap) {
 					const es = new EventSource("/dsh-taskboard/events");
 					let revision;
 					const hello = (event) => {
-						const payload = JSON.parse(event.data);
+						let payload;
+						try {
+							payload = JSON.parse(event.data);
+						} catch {
+							return;
+						}
 						if (revision !== void 0 && payload.revision !== revision) onGap();
 						revision = payload.revision;
 					};
 					const change = (event) => {
-						const payload = JSON.parse(event.data);
+						let payload;
+						try {
+							payload = JSON.parse(event.data);
+						} catch {
+							return;
+						}
 						if (revision !== void 0 && payload.revision !== revision + 1) onGap();
 						revision = payload.revision;
 						onChange(payload);
@@ -134,6 +152,16 @@ window.__ModuleLoader__.load({
 			return TRANSITIONS[from].includes(to);
 		}
 		/**
+		* Factory-default isolation (0.5.0): 原目录执行. Applies when neither the
+		* task record nor the board setting (`BoardSettings.defaultIsolation`)
+		* says otherwise. Before 0.5.0 the implicit default was 'worktree'.
+		*/
+		const DEFAULT_ISOLATION = "none";
+		/** The effective default isolation for NEW tasks (board setting → factory default). */
+		function defaultIsolationOf(settings) {
+			return settings?.defaultIsolation ?? "none";
+		}
+		/**
 		* Parse a five-field cron expression. Supported field syntax: star, star/step
 		* (`* / n` without spaces), a single number, an `a-b` range, and comma lists
 		* of those. Day-of-week accepts both 0 and 7 as Sunday (normalized to 0).
@@ -238,22 +266,6 @@ window.__ModuleLoader__.load({
 		//#region src/client/controller.ts
 		/** localStorage key for persisted view state (filters + sort). */
 		const VIEW_KEY = "dsh-taskboard-view-v1";
-		/** localStorage key for the remembered isolation toggle choice (0.3.0). */
-		const ISOLATION_KEY = "dsh-taskboard-isolation-v1";
-		/** Load the remembered default isolation (worktree unless explicitly turned off). */
-		function loadDefaultIsolation() {
-			try {
-				return localStorage.getItem(ISOLATION_KEY) === "none" ? "none" : "worktree";
-			} catch {
-				return "worktree";
-			}
-		}
-		/** Remember the isolation toggle choice across forms (best effort). */
-		function saveDefaultIsolation(mode) {
-			try {
-				localStorage.setItem(ISOLATION_KEY, mode);
-			} catch {}
-		}
 		/** Load the persisted view state (never throws; fresh on any parse error). */
 		function loadView() {
 			try {
@@ -294,7 +306,8 @@ window.__ModuleLoader__.load({
 				diagOpen: false,
 				templates: [],
 				tplManagerOpen: false,
-				importOpen: false
+				importOpen: false,
+				settingsOpen: false
 			};
 		}
 		/**
@@ -307,7 +320,11 @@ window.__ModuleLoader__.load({
 			disposed = false;
 			disposeStream;
 			refreshInFlight;
+			/** Newest change-frame revision seen on the SSE stream (S16 refresh chase). */
+			seenRevision;
 			sessionJumper;
+			/** Composer catalog faces, installed formally by the client entry (T13). */
+			catalogFaces = {};
 			/** @param client - the route client. */
 			constructor(client) {
 				this.client = client;
@@ -336,10 +353,7 @@ window.__ModuleLoader__.load({
 			start() {
 				this.refresh();
 				this.disposeStream = this.client.stream((change) => {
-					this.setState({ ledger: {
-						...this.state.ledger,
-						revision: change.revision
-					} });
+					this.seenRevision = change.revision;
 					this.refresh();
 				}, () => {
 					this.refresh();
@@ -350,15 +364,18 @@ window.__ModuleLoader__.load({
 				if (this.refreshInFlight !== void 0) return this.refreshInFlight;
 				this.refreshInFlight = (async () => {
 					try {
-						const [ledger, workspaces] = await Promise.all([this.client.state(), this.client.workspaces()]);
-						let selected;
-						if (this.state.selectedId !== void 0) selected = ledger.tasks.find((t) => t.id === this.state.selectedId);
-						this.setState({
-							ledger,
-							workspaces,
-							error: void 0,
-							selectedId: selected === void 0 ? void 0 : this.state.selectedId
-						});
+						for (let round = 0; round < 3; round++) {
+							const [ledger, workspaces] = await Promise.all([this.client.state(), this.client.workspaces()]);
+							let selected;
+							if (this.state.selectedId !== void 0) selected = ledger.tasks.find((t) => t.id === this.state.selectedId);
+							this.setState({
+								ledger,
+								workspaces,
+								error: void 0,
+								selectedId: selected === void 0 ? void 0 : this.state.selectedId
+							});
+							if (this.seenRevision === void 0 || ledger.revision >= this.seenRevision) break;
+						}
 					} catch (error) {
 						this.setState({ error: error instanceof Error ? error.message : String(error) });
 					} finally {
@@ -476,6 +493,22 @@ window.__ModuleLoader__.load({
 			installSessionJumper(jumper) {
 				this.sessionJumper = jumper;
 			}
+			/** T13: formal installers for the composer catalog faces (was a monkeypatch from the client entry). */
+			installModelCatalog(fn) {
+				this.catalogFaces.models = fn;
+			}
+			/** T13: formal installer for the preset roster face. */
+			installPresetRoster(fn) {
+				this.catalogFaces.presets = fn;
+			}
+			/** The installed model catalog face, when the runtime provides one. */
+			get modelCatalog() {
+				return this.catalogFaces.models;
+			}
+			/** The installed preset roster face, when the runtime provides one. */
+			get presetCatalog() {
+				return this.catalogFaces.presets;
+			}
 			/**
 			* Jump to an execution's session (open it in the GUI). On success the board
 			* closes so the conversation shows; a deleted-or-archived session reports
@@ -609,13 +642,18 @@ window.__ModuleLoader__.load({
 					return;
 				}
 			}
-			/** Append a user comment. */
+			/**
+			* Append a user comment. Returns whether it landed — the composer keeps its
+			* text on failure (T13: it used to clear unconditionally and lose the draft).
+			*/
 			async comment(id, body) {
 				try {
 					await this.client.comment(id, body);
 					await this.refresh();
+					return true;
 				} catch (error) {
 					this.setState({ error: error instanceof Error ? error.message : String(error) });
+					return false;
 				}
 			}
 			/** Trigger a manual run (fresh in-project session, pinned model); `reuse` = 续跑. */
@@ -683,6 +721,29 @@ window.__ModuleLoader__.load({
 			closeDiagnostics() {
 				this.setState({ diagOpen: false });
 			}
+			/** Open the board-settings modal (0.5.0). */
+			openSettings() {
+				this.setState({ settingsOpen: true });
+			}
+			/** Close the board-settings modal. */
+			closeSettings() {
+				this.setState({ settingsOpen: false });
+			}
+			/**
+			* Replace board settings (0.5.0). The host broadcasts a settings-updated
+			* frame; refresh() pulls ledger.settings so every open view follows.
+			* @returns whether the write succeeded.
+			*/
+			async updateSettings(body) {
+				try {
+					await this.client.updateSettings(body);
+					await this.refresh();
+					return true;
+				} catch (error) {
+					this.setState({ error: error instanceof Error ? error.message : String(error) });
+					return false;
+				}
+			}
 			/** Clean one orphan worktree (⚙ panel); refreshes the diagnostics payload. */
 			async cleanupOrphan(workspaceId, taskId) {
 				try {
@@ -710,7 +771,7 @@ window.__ModuleLoader__.load({
 			async duplicate(task) {
 				try {
 					await this.client.create({
-						title: `${task.title}（副本）`,
+						title: `${task.title.slice(0, 196)}（副本）`,
 						workspaceId: task.workspaceId,
 						urgency: task.urgency,
 						description: task.description.length > 0 ? task.description : void 0,
@@ -835,7 +896,8 @@ window.__ModuleLoader__.load({
 			/** Download the task list as a CSV (BOM-prefixed for Excel + Chinese text). */
 			exportCsv() {
 				const esc = (v) => {
-					const s = String(v ?? "");
+					let s = String(v ?? "");
+					if (/^[=+\-@\t\r]/.test(s)) s = `'${s}`;
 					return /[",\n\r]/.test(s) ? `"${s.replace(/"/g, "\"\"")}"` : s;
 				};
 				const header = [
@@ -1585,6 +1647,10 @@ window.__ModuleLoader__.load({
 		.dsh-atb-imp-row-status { font-size: 10.5px; color: var(--dsw-alias-label-tertiary, gray); flex-shrink: 0; }
 		.dsh-atb-imp-result { font-size: 12px; color: var(--dsw-alias-state-success-primary, #30a46c); margin-top: 10px; }
 		.dsh-atb-badge[data-kind="checklist"] { color: var(--dsw-alias-label-secondary, inherit); }
+		/* ---------- 0.5.0 board settings ---------- */
+		.dsh-atb-set { max-width: 460px; width: min(460px, 92vw); }
+		.dsh-atb-set .dsh-atb-mode-picker { margin-top: 8px; }
+		.dsh-atb-set .dsh-atb-isolation-note { margin-top: 10px; }
 		`;
 		/** Style element id (stable since 0.1.x: hook for tests and debugging). */
 		const STYLE_ID = "dsh-taskboard-styles";
@@ -1794,7 +1860,8 @@ window.__ModuleLoader__.load({
 				found: false,
 				placed: false
 			};
-			window.__atbDebug = debug;
+			const host = globalThis.location?.hostname;
+			if (host === "localhost" || host === "127.0.0.1") window.__atbDebug = debug;
 			let root;
 			let placed = false;
 			const tryPlace = () => {
@@ -1865,7 +1932,70 @@ window.__ModuleLoader__.load({
 		* @module dsh-taskboard/shared/version
 		*/
 		/** The package version (must equal package.json "version"). */
-		const PLUGIN_VERSION = "0.4.5";
+		const PLUGIN_VERSION = "0.5.1";
+
+		//#endregion
+		//#region src/client/board/labels.ts
+		/** Column headers on the five-column main board (+ secondary tab). */
+		const COLUMN_LABELS = {
+			backlog: "待规划",
+			todo: "待办",
+			in_progress: "进行中",
+			in_review: "待验收",
+			done: "已完成",
+			canceled: "已取消",
+			archived: "已归档"
+		};
+		/** Status pill text (detail pane) — historical wording kept verbatim:
+		*  terminal states read short here, the column headers carry the full forms. */
+		const STATUS_LABEL = {
+			backlog: "待规划",
+			todo: "待办",
+			in_progress: "进行中",
+			in_review: "待验收",
+			done: "完成",
+			canceled: "取消",
+			archived: "归档"
+		};
+		/** Move-button verbs (shorter than the pill text). */
+		const MOVE_LABEL = {
+			backlog: "待规划",
+			todo: "待办",
+			in_progress: "进行中",
+			in_review: "待验收",
+			done: "完成",
+			canceled: "取消",
+			archived: "归档"
+		};
+		/** Urgency chip labels. */
+		const URGENCY_LABEL = {
+			urgent: "紧急",
+			normal: "一般",
+			relaxed: "不急"
+		};
+		/** Execution outcome labels. */
+		const OUTCOME_LABEL = {
+			running: "执行中",
+			succeeded: "成功",
+			failed: "失败",
+			cancelled: "已取消"
+		};
+
+		//#endregion
+		//#region src/client/board/format.ts
+		/** Format an epoch ms as a short local stamp. */
+		function fmtTime(ms) {
+			if (ms === void 0) return "";
+			const d = new Date(ms);
+			const pad = (n) => String(n).padStart(2, "0");
+			return `${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}`;
+		}
+		/** A claim idle for longer than this is highlighted as stale (ms). */
+		const STALE_CLAIM_MS = 30 * 6e4;
+		/** Whether the task's claim is stale (in_progress, held, idle too long). */
+		function isStaleClaim(task, now) {
+			return task.status === "in_progress" && task.claimedAt !== void 0 && now - task.claimedAt > 18e5;
+		}
 
 		//#endregion
 		//#region src/client/board/TaskCard.tsx
@@ -1882,17 +2012,6 @@ window.__ModuleLoader__.load({
 		*
 		* @module dsh-taskboard/client/board/TaskCard
 		*/
-		const URGENCY_LABEL$1 = {
-			urgent: "紧急",
-			normal: "一般",
-			relaxed: "不急"
-		};
-		const OUTCOME_LABEL$1 = {
-			running: "执行中",
-			succeeded: "成功",
-			failed: "失败",
-			cancelled: "已取消"
-		};
 		/** dataTransfer type carrying the dragged task id. */
 		const DRAG_TYPE = "application/x-dsh-atb-task";
 		/**
@@ -1928,7 +2047,7 @@ window.__ModuleLoader__.load({
 				onDragStart: (e) => {
 					if (running !== void 0) {
 						e.preventDefault();
-						const msg = `该任务正在由【${task.title}】会话执行，不能拖动`;
+						const msg = `该任务正由会话执行中（${task.title}），不能拖动`;
 						if (onAlert !== void 0) onAlert(msg);
 						else alert(msg);
 						return;
@@ -1958,7 +2077,7 @@ window.__ModuleLoader__.load({
 						children: [
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 								className: "dsh-atb-badge",
-								children: URGENCY_LABEL$1[task.urgency]
+								children: URGENCY_LABEL[task.urgency]
 							}),
 							task.blocked && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 								className: "dsh-atb-badge",
@@ -1998,7 +2117,7 @@ window.__ModuleLoader__.load({
 							last !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 								className: "dsh-atb-badge",
 								"data-kind": last.outcome === "running" ? "running" : last.outcome,
-								children: OUTCOME_LABEL$1[last.outcome] ?? last.outcome
+								children: OUTCOME_LABEL[last.outcome] ?? last.outcome
 							}),
 							task.comments.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", { children: ["💬 ", task.comments.length] }),
 							task.trashedAt !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
@@ -2151,27 +2270,6 @@ window.__ModuleLoader__.load({
 				"archived"
 			].filter((to) => canTransition(task.status, to));
 		}
-		const MOVE_LABEL = {
-			backlog: "待规划",
-			todo: "待办",
-			in_progress: "进行中",
-			in_review: "待验收",
-			done: "完成",
-			canceled: "取消",
-			archived: "归档"
-		};
-		const STATUS_LABEL = { ...MOVE_LABEL };
-		const URGENCY_LABEL = {
-			urgent: "紧急",
-			normal: "一般",
-			relaxed: "不急"
-		};
-		const OUTCOME_LABEL = {
-			running: "执行中",
-			succeeded: "成功",
-			failed: "失败",
-			cancelled: "已取消"
-		};
 		/** Compact session-id display (execution sessions carry the taskboard infix). */
 		function shortId(id) {
 			if (id === void 0) return "";
@@ -2640,6 +2738,7 @@ window.__ModuleLoader__.load({
 			const [confirmDone, setConfirmDone] = (0, react.useState)(false);
 			const [confirmPurge, setConfirmPurge] = (0, react.useState)(false);
 			const [confirmCancel, setConfirmCancel] = (0, react.useState)(false);
+			const [actionBusy, setActionBusy] = (0, react.useState)(false);
 			const { alert: showAlert, el: alertEl } = useAlert();
 			const ws = controller.getSnapshot().workspaces.find((w) => w.id === task.workspaceId);
 			const canRun = task.status !== "in_progress" && task.status !== "done" && task.status !== "archived";
@@ -2647,6 +2746,12 @@ window.__ModuleLoader__.load({
 			const holder = task.status === "in_progress" ? task.claimedBy : void 0;
 			const stale = now !== void 0 && isStaleClaim(task, now);
 			const unchecked = (task.checklist ?? []).filter((i) => !i.checked).length;
+			/** Fire one top action under the shared busy guard; re-enable on settle. */
+			const runAction = (action) => {
+				if (actionBusy) return;
+				setActionBusy(true);
+				action().catch(() => void 0).finally(() => setActionBusy(false));
+			};
 			/** Jump to an execution's session; prompt precisely when it cannot open. */
 			const jumpToSession = (sessionId) => {
 				controller.openSession(sessionId).then((result) => {
@@ -2746,7 +2851,7 @@ window.__ModuleLoader__.load({
 										"更新 ",
 										fmtTime(task.updatedAt),
 										" · 最近操作 ",
-										task.updatedBy.kind === "agent" ? `🤖 ${shortId(task.updatedBy.sessionId)}` : "👤 用户"
+										task.updatedBy.kind === "agent" ? `🤖 ${shortId(task.updatedBy.sessionId)}` : task.updatedBy.kind === "system" ? "⚙️ 系统" : "👤 用户"
 									]
 								})
 							]
@@ -2763,32 +2868,34 @@ window.__ModuleLoader__.load({
 									type: "button",
 									className: "dsh-atb-detail-edit",
 									title: "复制此任务的全部配置为一张新卡（待办列）",
-									onClick: () => void controller.duplicate(task),
+									disabled: actionBusy,
+									onClick: () => runAction(() => controller.duplicate(task)),
 									children: "⧉ 复制"
 								}),
 								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 									type: "button",
 									className: "dsh-atb-detail-edit",
 									title: "把此任务的配置（含清单）保存为模板，新建任务时可用",
-									onClick: () => {
-										controller.saveAsTemplate(task).then((ok) => {
-											if (ok) showAlert("已存为模板（新建任务 ▼ 下拉可用，可在模板管理中改名）");
-										});
-									},
+									disabled: actionBusy,
+									onClick: () => runAction(async () => {
+										if (await controller.saveAsTemplate(task)) showAlert("已存为模板（新建任务 ▼ 下拉可用，可在模板管理中改名）");
+									}),
 									children: "⌗ 存为模板"
 								}),
 								canRun && task.branch !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 									type: "button",
 									className: "dsh-atb-detail-run",
 									title: "续跑：保留现有 worktree 与分支（上次的改动和提交都在原处），在其上继续执行；默认「立即执行」会重置为全新基线",
-									onClick: () => void controller.run(task.id, true),
+									disabled: actionBusy,
+									onClick: () => runAction(() => controller.run(task.id, true)),
 									children: "↻ 续跑"
 								}),
 								canRun && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 									type: "button",
 									className: "dsh-atb-detail-run",
 									title: task.model !== void 0 ? `新会话执行（${task.model.model}）` : "新会话执行（默认模型）",
-									onClick: () => void controller.run(task.id),
+									disabled: actionBusy,
+									onClick: () => runAction(() => controller.run(task.id)),
 									children: "▶ 立即执行"
 								}),
 								runningExecution !== void 0 && (confirmCancel ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
@@ -2962,18 +3069,18 @@ window.__ModuleLoader__.load({
 									placeholder: "以用户身份留言（agent 开工前会读）…",
 									onChange: (e) => setComment(e.target.value),
 									onKeyDown: (e) => {
-										if ((e.ctrlKey || e.metaKey) && e.key === "Enter" && comment.trim().length > 0) {
-											controller.comment(task.id, comment);
-											setComment("");
-										}
+										if ((e.ctrlKey || e.metaKey) && e.key === "Enter" && comment.trim().length > 0) controller.comment(task.id, comment).then((ok) => {
+											if (ok) setComment("");
+										});
 									}
 								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 									type: "button",
 									className: "dsh-atb-composer-send",
 									disabled: comment.trim().length === 0,
 									onClick: () => {
-										controller.comment(task.id, comment);
-										setComment("");
+										controller.comment(task.id, comment).then((ok) => {
+											if (ok) setComment("");
+										});
 									},
 									children: "发表"
 								})]
@@ -3231,12 +3338,13 @@ window.__ModuleLoader__.load({
 			const [presetId, setPresetId] = (0, react.useState)(initialPreset);
 			const [presets, setPresets] = (0, react.useState)([]);
 			const [presetDefault, setPresetDefault] = (0, react.useState)(void 0);
-			const [isolation, setIsolation] = (0, react.useState)(task?.isolation ?? (prefill?.isolation === "none" ? "none" : prefill?.isolation === "worktree" ? "worktree" : loadDefaultIsolation()));
+			const [isolation, setIsolation] = (0, react.useState)(task?.isolation ?? (prefill?.isolation === "none" ? "none" : prefill?.isolation === "worktree" ? "worktree" : defaultIsolationOf(state.ledger.settings)));
 			const [checkRows, setCheckRows] = (0, react.useState)(task?.checklist !== void 0 && task.checklist.length > 0 ? task.checklist.map((i) => ({ ...i })) : (prefill?.checklist ?? []).map((text) => ({
 				text,
 				checked: false
 			})));
 			const titleRef = (0, react.useRef)(null);
+			const [busy, setBusy] = (0, react.useState)(false);
 			(0, react.useEffect)(() => {
 				titleRef.current?.focus();
 				const onKey = (e) => {
@@ -3256,10 +3364,11 @@ window.__ModuleLoader__.load({
 				face().then((roster) => {
 					setPresets(roster.presets);
 					setPresetDefault(roster.defaultId);
-					if (task?.presetId === void 0 && initialPreset === "" && roster.defaultId !== void 0) setPresetId(roster.defaultId);
+					if (!editing && initialPreset === "" && roster.defaultId !== void 0) setPresetId(roster.defaultId);
 				}).catch(() => setPresets([]));
 			}, [
 				controller,
+				editing,
 				task?.presetId,
 				initialPreset
 			]);
@@ -3271,10 +3380,12 @@ window.__ModuleLoader__.load({
 			const isolationLocked = editing && ((task.executions?.length ?? 0) > 0 || task.status === "in_progress");
 			const gitOk = controller.gitAvailable(workspaceId);
 			const isolationDisabled = isolationLocked || !gitOk;
-			/** Isolation payload for submit: undefined keeps the default (degrades naturally). */
+			/**
+			* Isolation payload for submit: undefined lets the HOST materialize the
+			* current board default at creation (non-git projects degrade naturally).
+			*/
 			const isolationPayload = () => {
 				if (!gitOk) return void 0;
-				if (!editing) saveDefaultIsolation(isolation);
 				return isolation;
 			};
 			/** Preset payload: '' = follow the deployment default (submit omits). */
@@ -3285,12 +3396,13 @@ window.__ModuleLoader__.load({
 				text: r.text.trim()
 			})).filter((r) => r.text.length > 0);
 			const submit = () => {
-				if (!valid) return;
+				if (!valid || busy) return;
 				const picked = model !== "" ? JSON.parse(model) : void 0;
 				const isolationOut = isolationPayload();
 				const presetOut = presetPayload();
 				const rows = filledRows();
-				if (editing) controller.update(task.id, task.version, {
+				setBusy(true);
+				(editing ? controller.update(task.id, task.version, {
 					title,
 					description,
 					prompt,
@@ -3304,8 +3416,7 @@ window.__ModuleLoader__.load({
 					...isolationOut !== void 0 && !isolationLocked ? { isolation: isolationOut } : {},
 					presetId: presetOut ?? null,
 					checklist: rows.length > 0 ? rows : null
-				});
-				else controller.create({
+				}) : controller.create({
 					title,
 					workspaceId,
 					urgency,
@@ -3319,50 +3430,52 @@ window.__ModuleLoader__.load({
 					...isolationOut !== void 0 ? { isolation: isolationOut } : {},
 					...presetOut !== void 0 ? { presetId: presetOut } : {},
 					...rows.length > 0 ? { checklist: rows.map((r) => r.text) } : {}
-				});
+				})).catch(() => void 0).finally(() => setBusy(false));
 			};
 			/** Save the form, then immediately trigger a manual run of the task. */
 			const submitAndRun = () => {
-				if (!valid || runBlocked) return;
+				if (!valid || runBlocked || busy) return;
 				const picked = model !== "" ? JSON.parse(model) : void 0;
 				const isolationOut = isolationPayload();
 				const presetOut = presetPayload();
 				const rows = filledRows();
-				if (editing) (async () => {
-					if (await controller.update(task.id, task.version, {
-						title,
-						description,
-						prompt,
-						urgency,
-						workspaceId,
-						execution: mode === "scheduled" ? {
-							mode,
-							cron: cron.trim()
-						} : { mode },
-						model: picked ?? null,
-						...isolationOut !== void 0 && !isolationLocked ? { isolation: isolationOut } : {},
-						presetId: presetOut ?? null,
-						checklist: rows.length > 0 ? rows : null
-					})) await controller.run(task.id);
-				})();
-				else (async () => {
-					const id = await controller.create({
-						title,
-						workspaceId,
-						urgency,
-						description: description.length > 0 ? description : void 0,
-						prompt: prompt.length > 0 ? prompt : void 0,
-						execution: mode === "scheduled" ? {
-							mode,
-							cron: cron.trim()
-						} : { mode },
-						model: picked,
-						...isolationOut !== void 0 ? { isolation: isolationOut } : {},
-						...presetOut !== void 0 ? { presetId: presetOut } : {},
-						...rows.length > 0 ? { checklist: rows.map((r) => r.text) } : {}
-					});
-					if (id !== void 0) await controller.run(id);
-				})();
+				setBusy(true);
+				(async () => {
+					if (editing) {
+						if (await controller.update(task.id, task.version, {
+							title,
+							description,
+							prompt,
+							urgency,
+							workspaceId,
+							execution: mode === "scheduled" ? {
+								mode,
+								cron: cron.trim()
+							} : { mode },
+							model: picked ?? null,
+							...isolationOut !== void 0 && !isolationLocked ? { isolation: isolationOut } : {},
+							presetId: presetOut ?? null,
+							checklist: rows.length > 0 ? rows : null
+						})) await controller.run(task.id);
+					} else {
+						const id = await controller.create({
+							title,
+							workspaceId,
+							urgency,
+							description: description.length > 0 ? description : void 0,
+							prompt: prompt.length > 0 ? prompt : void 0,
+							execution: mode === "scheduled" ? {
+								mode,
+								cron: cron.trim()
+							} : { mode },
+							model: picked,
+							...isolationOut !== void 0 ? { isolation: isolationOut } : {},
+							...presetOut !== void 0 ? { presetId: presetOut } : {},
+							...rows.length > 0 ? { checklist: rows.map((r) => r.text) } : {}
+						});
+						if (id !== void 0) await controller.run(id);
+					}
+				})().catch(() => void 0).finally(() => setBusy(false));
 			};
 			const hint = !valid ? title.trim().length === 0 ? "请填写标题" : workspaceId === "" ? "请选择项目" : "Cron 表达式无效（分 时 日 月 周）" : mode === "scheduled" && nextRun !== null ? `下次运行 ${fmtTime(nextRun)}` : editing ? `保存后版本 v${task.version} → v${task.version + 1}` : "创建后项目内会话可认领执行";
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
@@ -3628,8 +3741,8 @@ window.__ModuleLoader__.load({
 									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 										type: "button",
 										className: "dsh-atb-btn",
-										disabled: !valid || runBlocked,
-										title: runBlocked ? "任务正在执行中，不能重复发起" : "保存后立即发起执行（新会话）",
+										disabled: !valid || runBlocked || busy,
+										title: runBlocked ? "任务正在执行中，不能重复发起" : busy ? "正在提交…" : "保存后立即发起执行（新会话）",
 										onClick: submitAndRun,
 										children: "⚡ 立即执行"
 									}),
@@ -3637,7 +3750,7 @@ window.__ModuleLoader__.load({
 										type: "button",
 										className: "dsh-atb-btn",
 										"data-primary": "true",
-										disabled: !valid,
+										disabled: !valid || busy,
 										onClick: submit,
 										children: editing ? "保存修改" : "创建任务"
 									})
@@ -3649,6 +3762,133 @@ window.__ModuleLoader__.load({
 			});
 		}
 
+		//#endregion
+		//#region src/client/board/SettingsModal.tsx
+		/**
+		* Board-settings modal (0.5.0): the user-owned defaults applied when a NEW
+		* task is created without an explicit choice. Currently one section — 默认执行
+		* 隔离 (worktree vs original directory); further sections can slot into the
+		* body below. Saving goes through the host route (whole-object replace) and
+		* the SSE change stream refreshes every open view.
+		*
+		* @module dsh-taskboard/client/board/SettingsModal
+		*/
+		/** The isolation options with one-line hints (mirrors the task form). */
+		const ISOLATION_OPTIONS = [{
+			value: "none",
+			name: "📁 原目录执行",
+			hint: "不使用 git，直接在项目目录工作（出厂默认）"
+		}, {
+			value: "worktree",
+			name: "🌿 Worktree 隔离",
+			hint: "每次执行在独立 worktree 分支上进行（task/标题+ID），互不污染"
+		}];
+		/**
+		* The 看板设置 modal: reads the live ledger settings, stages a local draft,
+		* and writes back through the controller on save.
+		* @param controller - the board controller.
+		*/
+		function SettingsModal({ controller }) {
+			const current = controller.getSnapshot().ledger.settings?.defaultIsolation ?? "none";
+			const [draft, setDraft] = (0, react.useState)(current);
+			const dirty = draft !== current;
+			const save = () => {
+				controller.updateSettings({ defaultIsolation: draft }).then((ok) => {
+					if (ok) controller.closeSettings();
+				});
+			};
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				className: "dsh-atb-modal-backdrop",
+				onClick: (e) => {
+					if (e.target === e.currentTarget) controller.closeSettings();
+				},
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "dsh-atb-modal dsh-atb-set",
+					role: "dialog",
+					"aria-modal": "true",
+					"aria-label": "看板设置",
+					children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dsh-atb-modal-head",
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									className: "dsh-atb-modal-headicon",
+									children: "🛠"
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "dsh-atb-modal-headtext",
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", { children: "看板设置" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: "新建任务时应用的默认值（不影响已有任务）" })]
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									className: "dsh-atb-modal-close",
+									"aria-label": "关闭",
+									onClick: () => controller.closeSettings(),
+									children: "✕"
+								})
+							]
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "dsh-atb-modal-body",
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+								className: "dsh-atb-diag-sec",
+								children: [
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h4", { children: "默认执行隔离" }),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+										className: "dsh-atb-mode-picker",
+										children: ISOLATION_OPTIONS.map((o) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+											type: "button",
+											className: "dsh-atb-mode-opt",
+											"data-on": draft === o.value,
+											title: o.hint,
+											onClick: () => setDraft(o.value),
+											children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+												className: "dsh-atb-mode-name",
+												children: o.name
+											}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+												className: "dsh-atb-mode-hint",
+												children: o.hint
+											})]
+										}, o.value))
+									}),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+										className: "dsh-atb-isolation-note",
+										children: [
+											"当前保存的默认：",
+											current === "worktree" ? "🌿 Worktree 隔离" : "📁 原目录执行",
+											"。 仅影响之后新建的任务；已有任务保持创建时的选择，非 git 项目运行时仍自动降级原目录。"
+										]
+									})
+								]
+							})
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dsh-atb-modal-foot",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: "dsh-atb-modal-hint",
+								children: dirty ? "有未保存的修改" : "与看板当前设置一致"
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+								className: "dsh-atb-modal-footbtns",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									className: "dsh-atb-btn",
+									onClick: () => controller.closeSettings(),
+									children: "取消"
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									className: "dsh-atb-btn",
+									"data-primary": "true",
+									disabled: !dirty,
+									onClick: save,
+									children: "保存设置"
+								})]
+							})]
+						})
+					]
+				})
+			});
+		}
+
 		//#endregion
 		//#region src/client/board/ImportModal.tsx
 		/**
@@ -3892,7 +4132,7 @@ window.__ModuleLoader__.load({
 									className: "dsh-atb-btn",
 									"data-primary": "true",
 									"data-danger": mode === "replace" && confirmReplace ? "true" : void 0,
-									disabled: plan === void 0 || busy || result !== void 0 && false,
+									disabled: plan === void 0 || busy,
 									onClick: commit,
 									children: mode === "replace" && confirmReplace ? "确认整册替换" : "执行导入"
 								})]
@@ -4082,35 +4322,6 @@ window.__ModuleLoader__.load({
 		*
 		* @module dsh-taskboard/client/board/TaskBoard
 		*/
-		/** Column labels. */
-		const COLUMN_LABELS = {
-			backlog: "待规划",
-			todo: "待办",
-			in_progress: "进行中",
-			in_review: "待验收",
-			done: "已完成",
-			canceled: "已取消",
-			archived: "已归档"
-		};
-		/** Urgency chip labels. */
-		const URGENCY_LABELS = {
-			urgent: "紧急",
-			normal: "一般",
-			relaxed: "不急"
-		};
-		/** Format an epoch ms as a short local stamp. */
-		function fmtTime(ms) {
-			if (ms === void 0) return "";
-			const d = new Date(ms);
-			const pad = (n) => String(n).padStart(2, "0");
-			return `${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}`;
-		}
-		/** A claim idle for longer than this is highlighted as stale (ms). */
-		const STALE_CLAIM_MS = 30 * 6e4;
-		/** Whether the task's claim is stale (in_progress, held, idle too long). */
-		function isStaleClaim(task, now) {
-			return task.status === "in_progress" && task.claimedAt !== void 0 && now - task.claimedAt > 18e5;
-		}
 		/** Urgency sort rank (urgent first). */
 		const URGENCY_RANK = {
 			urgent: 0,
@@ -4144,6 +4355,8 @@ window.__ModuleLoader__.load({
 			const { alert: showAlert, el: alertEl } = useAlert();
 			const [newMenuOpen, setNewMenuOpen] = (0, react.useState)(false);
 			const closeMenu = () => setNewMenuOpen(false);
+			const [exportOpen, setExportOpen] = (0, react.useState)(false);
+			const closeExport = () => setExportOpen(false);
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "dsh-atb-board",
 				children: [
@@ -4189,7 +4402,7 @@ window.__ModuleLoader__.load({
 											},
 											children: "空白任务"
 										}),
-										state.templates.map((t) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+										state.templates.map((t) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 											type: "button",
 											className: "dsh-atb-newmenu-opt",
 											title: t.task.description !== void 0 && t.task.description.length > 0 ? t.task.description.slice(0, 120) : t.name,
@@ -4197,7 +4410,7 @@ window.__ModuleLoader__.load({
 												closeMenu();
 												controller.newFromTemplate(t.task);
 											},
-											children: [t.name, t.builtin === true ? "" : ""]
+											children: t.name
 										}, t.id)),
 										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { className: "dsh-atb-newmenu-sep" }),
 										/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
@@ -4269,7 +4482,7 @@ window.__ModuleLoader__.load({
 								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 									className: "dsh-atb-dot",
 									"data-urgency": u
-								}), URGENCY_LABELS[u]]
+								}), URGENCY_LABEL[u]]
 							}, u)),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 								type: "button",
@@ -4277,6 +4490,13 @@ window.__ModuleLoader__.load({
 								onClick: () => controller.toggleSecondary(),
 								children: state.secondaryOpen ? "返回看板" : "其它任务"
 							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: "dsh-atb-btn",
+								title: "看板设置：新建任务的默认执行隔离等",
+								onClick: () => controller.openSettings(),
+								children: "🛠 设置"
+							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 								type: "button",
 								className: "dsh-atb-btn",
@@ -4291,19 +4511,39 @@ window.__ModuleLoader__.load({
 								onClick: () => controller.openImport(),
 								children: "⬆ 导入"
 							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-								type: "button",
-								className: "dsh-atb-btn",
-								title: "下载完整台账备份（JSON）",
-								onClick: () => controller.exportJson(),
-								children: "⬇ JSON"
-							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-								type: "button",
-								className: "dsh-atb-btn",
-								title: "下载任务清单（CSV）",
-								onClick: () => controller.exportCsv(),
-								children: "⬇ CSV"
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: "dsh-atb-newmenu",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									className: "dsh-atb-btn",
+									title: "导出台账：完整 JSON 备份或任务清单 CSV",
+									onClick: () => setExportOpen(!exportOpen),
+									children: "⬇ 导出 ▼"
+								}), exportOpen && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: "dsh-atb-newmenu-backdrop",
+									onClick: closeExport
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									className: "dsh-atb-newmenu-list",
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: "dsh-atb-newmenu-opt",
+										title: "完整台账备份（含执行历史与看板设置），可用于导入恢复",
+										onClick: () => {
+											closeExport();
+											controller.exportJson();
+										},
+										children: "完整台账（JSON）"
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: "dsh-atb-newmenu-opt",
+										title: "任务清单表格（Excel 可直接打开，中文已加 BOM）",
+										onClick: () => {
+											closeExport();
+											controller.exportCsv();
+										},
+										children: "任务清单（CSV）"
+									})]
+								})] })]
 							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("a", {
 								className: "dsh-atb-ver",
@@ -4385,13 +4625,14 @@ window.__ModuleLoader__.load({
 							task: selected,
 							controller,
 							now
-						})
+						}, selected.id)
 					}),
 					state.composerOpen && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TaskFormModal, {
 						controller,
 						task: state.editingId === void 0 ? void 0 : state.ledger.tasks.find((t) => t.id === state.editingId)
 					}),
 					state.diagOpen && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DiagnosticsPanel, { controller }),
+					state.settingsOpen && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SettingsModal, { controller }),
 					state.importOpen && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ImportModal, { controller }),
 					state.tplManagerOpen && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TemplateManager, { controller }),
 					alertEl
@@ -4734,7 +4975,7 @@ window.__ModuleLoader__.load({
 				const controller = new BoardController(createClient());
 				const connection = ctx.get?.("connection");
 				if (connection !== void 0) {
-					controller.modelCatalog = async () => {
+					controller.installModelCatalog(async () => {
 						const response = await connection.api.llm.models({});
 						if (!response.result.ok) return [];
 						const out = [];
@@ -4744,8 +4985,8 @@ window.__ModuleLoader__.load({
 							name: model.name
 						});
 						return out;
-					};
-					controller.presetCatalog = async () => {
+					});
+					controller.installPresetRoster(async () => {
 						const list = connection.api.agentPresets;
 						if (list === void 0) return { presets: [] };
 						const response = await list.list({});
@@ -4759,7 +5000,7 @@ window.__ModuleLoader__.load({
 							presets,
 							...def !== void 0 ? { defaultId: def.id } : {}
 						};
-					};
+					});
 				}
 				controller.installSessionJumper(createSessionJumper({
 					getSessions: () => ctx.get?.("sessions"),