dsh-taskboard 0.1.0 → 0.1.2

package/README.md

@@ -1,169 +1,66 @@
+[![npm version](https://img.shields.io/npm/v/dsh-taskboard.svg)](https://www.npmjs.com/package/dsh-taskboard)
+[![License](https://img.shields.io/npm/l/dsh-taskboard.svg)](https://github.com/cloader/dsh-taskboard/blob/main/LICENSE)
+
 # dsh-taskboard
 
-DeepSeek Harness（DSH）的 **Agent 任务看板插件**：人把工作拆成卡片挂上看板，agent 会话通过 `taskboard_*` 工具认领、推进、评论、移交，人最终验收。双向协作，不是单向 todo 列表。
+DeepSeek Harness 的**任务看板插件**：人建卡、agent 认领执行、人验收。任务挂项目（workspace）、可指定模型、支持手动与定时执行，全流程双向协作。
 
-```
-人在 GUI 建卡（选项目/紧急度/模型/执行方式）
-        │
-        ▼
-看板 ◄──SSE 实时刷新──┐
-        │              │ agent 会话内：
-   [手动执行/定时触发]  │ taskboard_get / comment_add / move
-        │              ▼
-        ▼           卡片 → in_progress →（实现+自验）→ in_review
-在任务项目里新建会话              agent 到此为止，永远到不了 done
-（指定模型，干净上下文）
-        │
-        ▼
-人在看板上确认 → done（唯一入口）
-```
+## 界面
 
-## 功能特性
-
-**Host 侧（agent 工具 + 台账 + 调度）**
-
-- **8 个 `taskboard_*` 工具**：任何会话中的 agent 都能查板、建卡、认领、移卡、评论、软删除
-- **任务挂项目**：项目直接映射 DSH workspace，零新实体；认领（todo→in_progress）校验调用会话归属，跨项目认领被拒
-- **紧急度三色**：urgent 红 / normal 紫 / relaxed 蓝，贯穿卡片、筛选、详情
-- **每任务可固定模型**：执行时创建会话即生效；未指定走部署默认模型
-- **两种执行方式**：认领制（项目内会话认领）或定时执行（host 侧 cron，关掉浏览器照样跑，错过窗口跳过不补跑）
-- **一键真实执行**：手动「执行」在任务项目内新建全新会话（干净上下文）提交任务 prompt，回合结算记入执行记录
-- **乐观并发**：所有写操作带 `ifVersion`，冲突返回 `version_conflict`
-- **完整归因**：每次变更记录 actor（user / agent+sessionId），评论区分作者
-- **host 权威台账**：`~/.dsh/dsh-taskboard.json` 原子持久化，全局 revision 单调递增，SSE 推送 + 断线全量对账
-
-**协议硬闸（代码级强制，不靠 prompt 自觉）**
-
-- agent 移卡到 `done` 一律 `forbidden` —— 完成只能由人在 GUI 确认
-- 认领要求会话 cwd 解析到任务所属 workspace（跨项目 = `workspace_mismatch`）
-- 任务被某 agent 会话持有期间，其他会话不可抢占（任何移动 `forbidden`）
-- agent 不可篡改任务的 model / execution 配置（归创建者/用户所有）
-
-**Client 侧（看板 UI）**
-
-- **五列看板**：待规划 / 待办 / 进行中 / 待验收 / 已完成；blocked 角标不占列；canceled / archived / 已删除收进「其它任务」页
-- **筛选栏**：项目下拉 + 紧急度三色 chip 多选
-- **任务卡片**：紧急度左缘色条、模型 / ⏰ 定时（下次运行时间）/ 受阻 / 最近执行结果角标、评论计数；backlog ↔ todo 拖拽
-- **新建 / 编辑任务弹窗**（`TaskFormModal`，新建与编辑共用）：
-  - 头部图标 + 副标题、双列网格表单、底部实时校验提示 + 操作按钮
-  - 紧急度色点卡片三选（各带副提示）、执行方式分段选择（认领制 / 定时）
-  - Cron 预设 chip 高亮选中，**实时校验**（非法表达式红框）+ **下次运行时间预览**（与 host 调度器同一套纯函数）
-  - 模型下拉读运行时已配置目录，「默认模型」为第一项
-  - Esc 关闭、自动聚焦标题、保存提示版本变化
-- **任务编辑**：详情面板「✎ 编辑」回填全部字段；GUI 作为 owner surface 可改标题 / 描述 / Prompt / 紧急度 / **项目改绑** / 执行方式 / 模型（含清除回默认）
-- **详情面板**：状态流转（done 二次确认）、受阻标记、用户/agent 气泡评论流、执行记录时间线（结果/耗时/会话短 id/错误摘要）、危险区（软删除→物理清除需确认）
-- **主题适配**：全部颜色走外壳 `--dsw-alias-*` 设计令牌，浅色 / 深色主题与皮肤自动跟随
-
-## 核心概念
-
-| 概念 | 说明 |
-|---|---|
-| 项目 | 直接映射 DSH workspace（无新实体）。任务创建时必须选一个 |
-| 紧急度 | `urgent` 红 / `normal` 紫 / `relaxed` 蓝，看板列内以色条区分，支持筛选 |
-| 状态机 | `backlog → todo → in_progress → in_review → done`，旁路 `canceled` / `archived`；`blocked` 是布尔标记不是状态 |
-| 执行方式 | `claim`（项目内会话认领）或 `scheduled`（host 侧 cron 定时触发） |
-| 模型 | 每任务可固定 `{provider, model}`；执行时应用到新建会话，未指定用部署默认模型 |
-| 乐观并发 | 所有写操作带 `ifVersion`，冲突返回 `version_conflict`（重读再试一次即可） |
-| 归因 | 每次变更记录 actor（user / agent+sessionId），评论挂 threadId |
-
-## Agent 工具（8 个）
-
-| 工具 | 作用 |
-|---|---|
-| `taskboard_list` | 按项目/状态/紧急度过滤列卡（开始工作前先看） |
-| `taskboard_get` | 读单卡全文（描述/prompt/评论/版本） |
-| `taskboard_create` | 建卡（需要 agent 身份） |
-| `taskboard_update` | 改标题/描述/prompt/紧急度/blocked（带 ifVersion） |
-| `taskboard_move` | 移动状态（带 ifVersion；**代码级拒绝 agent 移到 done**） |
-| `taskboard_comment_add` | 追加进度/报告评论 |
-| `taskboard_comments` | 列评论（先读再决定开工） |
-| `taskboard_delete` | 软删除（agent 只能标记，人在 GUI 清除） |
-
-Agent 工作流协议（随插件注入 system prompt）：开工先查板 → 先读后动 → 先认领再干活 → 冲突只重试一次 → 自验后移 in_review 留评论 → `done` 永远由人确认 → backlog 未授权不执行 → model/execution 只读。
-
-## 执行链路
-
-手动「执行」按钮或 cron 到期都走同一条路：
-
-1. 卡片置 `in_progress`，台账追加 execution 记录（`running`）；
-2. 在任务项目目录里新建全新会话（干净上下文），带任务固定模型或部署默认模型；
-3. 会话 attach 到 workspace（GUI 项目会话列表可见、可回链）；
-4. 任务 prompt 作为普通用户消息提交，消息头带任务 ID 与状态说明；
-5. 回合结算：成功 → `succeeded`；回合错误 → `failed`（错误入台账）。
-
-调度器每分钟 tick；到期任务先顺延 `nextRunAt` 再触发；错过超过 5 分钟的窗口跳过不补跑。
+<p align="center"><img src="https://raw.githubusercontent.com/cloader/dsh-taskboard/main/img/board.png" alt="任务看板" width="880"></p>
 
-## 安装
+<p align="center"><img src="https://raw.githubusercontent.com/cloader/dsh-taskboard/main/img/modal.png" alt="新建任务" width="440"></p>
 
-**GitHub 源安装**（收录 [awesome-dsh-plugin 精选列表](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)后，dshmarket 市场里的一键安装走的也是这条路）：
+## 核心功能
 
-```bash
-dsh plugin --profile <name> add github:cloader/dsh-taskboard
-```
+**看板协作**
+- 五列看板（待规划 / 待办 / 进行中 / 待验收 / 已完成）+ 受阻标记，SSE 实时刷新
+- 任务挂项目：认领校验会话归属，跨项目不可抢
+- 紧急度三色（紧急/一般/不急）筛选与色条
+- 新建/编辑弹窗：项目、模型、紧急度、执行方式、cron 实时校验与下次运行预览
+- 详情面板：状态流转（done 仅限人工）、agent/用户评论流、执行记录回链会话
 
-> 构建产物 `lib/` 已随仓库提交：安装即用，无本地构建、无构建脚本授权（`allowBuilds`）。
+**Agent 工具（taskboard_\*）**
+- 8 个工具：查板 / 建卡 / 改卡 / 移卡 / 评论 / 软删除，任何会话可用
+- 代码级协议闸：agent 永远移不到 done；任务被持有时不可抢占；model/execution 对 agent 只读
 
-**npm 裸名安装**（需先将包发布到 npm；同样是预构建，免构建授权）：
+**执行**
+- 手动执行或 cron 定时：每次执行在任务项目内新建全新会话（干净上下文、可指定模型）
+- host 侧调度：关掉浏览器照常触发；错过窗口跳过不补跑
+- 乐观并发（ifVersion）+ 完整归因（谁改的、哪个会话执行的）
 
-```bash
-dsh plugin --profile <name> add dsh-taskboard
-```
+## 安装
 
-本地 link 开发：profile 的 `package.json`：
-
-```json
-{
-  "dependencies": {
-    "dsh-taskboard": "link:D:/path/to/dsh-taskboard"
-  },
-  "dsh": {
-    "profile": {
-      "bundles": [
-        "@deepseek-ai/dsh-base",
-        "@deepseek-ai/dsh-web-app",
-        "dsh-taskboard"
-      ]
-    }
-  }
-}
+```bash
+dsh plugin --profile <name> add dsh-taskboard          # npm（推荐，预构建免授权）
+dsh plugin --profile <name> add github:cloader/dsh-taskboard   # GitHub 源
 ```
 
-然后 `dsh plugin --profile <name> add link:D:/path/to/dsh-taskboard`。
-
-> ⚠️ 官方 `@deepseek-ai/dsh-*` 包只写进 `bundles` 列表，**不要** `plugin add` 进 profile dependencies（会引发 SDK 双实例遮蔽，详见项目根 README 的踩坑记录）。
-
-host 侧改动需重启 `dsh web`；client 侧改动 rebuild 后刷新页面。
+> 官方 `@deepseek-ai/dsh-*` 包只写进 profile 的 `bundles` 列表，不要 `plugin add` 进 dependencies（避免 SDK 双实例遮蔽）。
 
 ## 开发
 
 ```bash
-npm install
-npm run build        # tsdown 双构建：host ESM + client CJS（wrap-client.mjs 包装）
-npm test             # vitest 41 项（protocol/tools/execution/routes/client）
-npm run typecheck
+npm install && npm run build    # host ESM + client CJS 双构建
+npm test                        # vitest 41 项
+node scripts/screenshot.mjs     # 重新生成 img/ 截图（需本机 Edge）
 ```
 
-## 架构
+## 升级日志
 
-```
-src/
-  shared/protocol.ts     # 状态机/紧急度/cron/记录类型（host+client 共享）
-  shared/api.ts          # HTTP/SSE 线上契约
-  host/
-    store.ts             # 台账：串行 mutate、原子持久化、订阅
-    tools.ts             # 8 个 taskboard_* 工具 + 代码级协议闸
-    sdk.ts               # SDK 兼容层（零运行时官方包 import）
-    protocol-text.ts     # agent 工作流协议 systemPrompt section
-    execution.ts         # 执行服务（新会话/模型/结算）
-    scheduler.ts         # host 侧 cron tick
-    routes.ts            # JSON + SSE HTTP 面
-  client/
-    index.ts             # 注入入口（connection）
-    api.ts controller.ts # fetch/SSE + useSyncExternalStore 状态源
-    board/*.tsx          # 看板视图（五列/筛选/卡片/详情/新建·编辑弹窗 TaskFormModal）
-    sidebar-entry.ts board-mount.tsx styles.ts
-tests/                   # vitest：protocol/tools/execution/routes/client + smoke-host
-  e2e/                  # dev-server 手工验证脚本（P0–P4，见 tests/e2e/README.md）
-```
+### 0.1.2
+
+- **看板拖拽**：所有列的卡片可互相拖动（按状态机校验合法流转，非法拖放弹窗提示）；正在执行的任务拖动会被拦截，提示「该任务正在由【任务名】会话执行，不能拖动」
+- **执行会话体验**：执行会话标题固定为任务名（经 `sessionTitle.rename` 写入，不会被自动重命名覆盖）；首条消息以正常用户消息呈现（不再是插件上下文行）
+- **交互优化**：
+  - 新建/编辑弹框新增「⚡ 立即执行」按钮（保存后直接发起执行）
+  - 详情页「立即执行」移至「编辑」按钮旁
+  - 「+ 新建任务」移至看板标题统计旁
+  - 状态流转按钮文案统一为「移至→{状态}」
+- **弹窗**：原生 `alert()` 全部替换为主题化模态弹窗（Esc/遮罩可关）
+
+### 0.1.1
+
+- 初始 npm 发布：看板协作、8 个 agent 工具、手动/cron 执行、SSE 实时视图
 
 License: Apache-2.0

package/lib/client.js

@@ -349,17 +349,19 @@ window.__ModuleLoader__.load({
 			toggleSecondary() {
 				this.setState({ secondaryOpen: !this.state.secondaryOpen });
 			}
-			/** Create a task (composer submit). */
+			/** Create a task (composer submit); returns the new task id, undefined on failure. */
 			async create(body) {
 				try {
-					await this.client.create(body);
+					const summary = await this.client.create(body);
 					this.setState({
 						composerOpen: false,
 						error: void 0
 					});
 					await this.refresh();
+					return summary.id;
 				} catch (error) {
 					this.setState({ error: error instanceof Error ? error.message : String(error) });
+					return;
 				}
 			}
 			/** Edit task fields (form modal submit; the GUI is the owner surface). */
@@ -375,8 +377,10 @@ window.__ModuleLoader__.load({
 						error: void 0
 					});
 					await this.refresh();
+					return true;
 				} catch (error) {
 					this.setState({ error: error instanceof Error ? error.message : String(error) });
+					return false;
 				}
 			}
 			/** Move a task (user surface: done allowed). */
@@ -608,12 +612,12 @@ window.__ModuleLoader__.load({
 		.dsh-atb-desc { white-space: pre-wrap; word-break: break-word; font-size: 13px; line-height: 1.55; }
 
 		.dsh-atb-detail-actions { display: flex; flex-direction: column; gap: 8px; }
-		.dsh-atb-runbtn {
-		  font: inherit; font-size: 13px; font-weight: 600; padding: 8px 14px; border-radius: 9px; cursor: pointer;
-		  border: 1px solid transparent; background: var(--dsw-alias-button-primary-fill, var(--dsw-alias-brand-primary, #1f2328)); color: var(--dsw-alias-label-primary-foreground, #fff); text-align: center;
+		.dsh-atb-detail-run {
+		  font: inherit; font-size: 12px; font-weight: 600; padding: 4px 11px; border-radius: 7px; cursor: pointer;
+		  border: 1px solid transparent; background: var(--dsw-alias-button-primary-fill, var(--dsw-alias-brand-primary, #1f2328)); color: var(--dsw-alias-label-primary-foreground, #fff);
 		  transition: filter .12s ease;
 		}
-		.dsh-atb-runbtn:hover { filter: brightness(1.1); }
+		.dsh-atb-detail-run:hover { filter: brightness(1.1); }
 		.dsh-atb-movebtns { display: flex; gap: 6px; flex-wrap: wrap; }
 		.dsh-atb-movebtn {
 		  font: inherit; font-size: 12px; padding: 4px 11px; border-radius: 999px; cursor: pointer;
@@ -812,6 +816,29 @@ window.__ModuleLoader__.load({
 		.dsh-atb-secondary { flex: 1; min-height: 0; overflow-y: auto; display: flex; flex-direction: column; gap: 8px; }
 		.dsh-atb-link { color: var(--dsw-alias-state-business-primary, #3e63dd); cursor: pointer; text-decoration: none; }
 		.dsh-atb-link:hover { text-decoration: underline; }
+
+		/* ---------- alert modal ---------- */
+		.dsh-atb-alert-backdrop {
+		  position: fixed; inset: 0; z-index: 90;
+		  background: var(--dsw-alias-bg-mask-drop, rgba(28,30,36,.4)); backdrop-filter: var(--dsw-mask-blur, blur(2px));
+		  display: flex; align-items: center; justify-content: center;
+		  animation: dsh-atb-fade .12s ease;
+		}
+		.dsh-atb-alert {
+		  min-width: 280px; max-width: 380px; padding: 20px 24px; border-radius: 14px;
+		  background: var(--dsw-alias-bg-overlay, #fff); color: var(--dsw-alias-label-primary, inherit);
+		  border: 1px solid var(--dsw-alias-border-l2, rgba(128,128,128,.25));
+		  box-shadow: var(--dsw-shadow-lv3, 0 12px 32px rgba(0,0,0,.18));
+		  display: flex; flex-direction: column; align-items: center; gap: 14px;
+		  animation: dsh-atb-pop .14s ease;
+		}
+		.dsh-atb-alert-icon { font-size: 28px; line-height: 1; }
+		.dsh-atb-alert-msg {
+		  font-size: 13.5px; line-height: 1.55; text-align: center;
+		  word-break: break-word; white-space: pre-wrap;
+		  color: var(--dsw-alias-label-primary, inherit);
+		}
+		.dsh-atb-alert .dsh-atb-btn { padding: 6px 28px; font-size: 13px; }
 		`;
 		let injected = false;
 		/** Inject the stylesheet once (idempotent). */
@@ -968,9 +995,10 @@ window.__ModuleLoader__.load({
 		* The card view.
 		* @param task - the task record.
 		* @param controller - the controller.
-		* @param draggable - enable dragging (backlog/todo columns only).
+		* @param draggable - enable dragging.
+		* @param onAlert - show an alert message (replaces native alert).
 		*/
-		function TaskCard({ task, controller, draggable = false }) {
+		function TaskCard({ task, controller, draggable = false, onAlert }) {
 			const last = task.executions.length > 0 ? task.executions[task.executions.length - 1] : void 0;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
 				type: "button",
@@ -978,6 +1006,13 @@ window.__ModuleLoader__.load({
 				"data-urgency": task.urgency,
 				draggable,
 				onDragStart: (e) => {
+					if (task.executions.find((ex) => ex.outcome === "running") !== void 0) {
+						e.preventDefault();
+						const msg = `该任务正在由【${task.title}】会话执行，不能拖动`;
+						if (onAlert !== void 0) onAlert(msg);
+						else alert(msg);
+						return;
+					}
 					e.dataTransfer.setData(DRAG_TYPE, task.id);
 					e.dataTransfer.effectAllowed = "move";
 					e.currentTarget.dataset.dragging = "true";
@@ -1179,18 +1214,28 @@ window.__ModuleLoader__.load({
 							]
 						}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 							className: "dsh-atb-detail-topbtns",
-							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-								type: "button",
-								className: "dsh-atb-detail-edit",
-								onClick: () => controller.openEditor(task.id),
-								children: "✎ 编辑"
-							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-								type: "button",
-								className: "dsh-atb-detail-close",
-								"aria-label": "关闭",
-								onClick: () => controller.select(void 0),
-								children: "✕"
-							})]
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									className: "dsh-atb-detail-edit",
+									onClick: () => controller.openEditor(task.id),
+									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),
+									children: "▶ 立即执行"
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									className: "dsh-atb-detail-close",
+									"aria-label": "关闭",
+									onClick: () => controller.select(void 0),
+									children: "✕"
+								})
+							]
 						})]
 					}),
 					task.description.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -1214,14 +1259,9 @@ window.__ModuleLoader__.load({
 							children: task.prompt
 						})]
 					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 						className: "dsh-atb-detail-actions",
-						children: [canRun && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
-							type: "button",
-							className: "dsh-atb-runbtn",
-							onClick: () => void controller.run(task.id),
-							children: ["▶ 执行 · 新会话", task.model !== void 0 ? `（${task.model.model}）` : "（默认模型）"]
-						}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 							className: "dsh-atb-movebtns",
 							children: [moveTargets(task).map((to) => to === "done" ? confirmDone ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 								className: "dsh-atb-confirm",
@@ -1252,13 +1292,13 @@ window.__ModuleLoader__.load({
 								className: "dsh-atb-movebtn",
 								"data-to": to,
 								onClick: () => setConfirmDone(true),
-								children: ["✓ ", MOVE_LABEL[to]]
-							}, to) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								children: ["移至→", MOVE_LABEL[to]]
+							}, to) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
 								type: "button",
 								className: "dsh-atb-movebtn",
 								"data-to": to,
 								onClick: () => void controller.move(task.id, task.version, to),
-								children: MOVE_LABEL[to]
+								children: ["移至→", MOVE_LABEL[to]]
 							}, to)), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 								type: "button",
 								className: "dsh-atb-movebtn",
@@ -1266,7 +1306,7 @@ window.__ModuleLoader__.load({
 								onClick: () => void controller.toggleBlocked(task),
 								children: task.blocked ? "✓ 解除受阻" : "⛔ 标记受阻"
 							})]
-						})]
+						})
 					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: "dsh-atb-section",
@@ -1509,6 +1549,7 @@ window.__ModuleLoader__.load({
 			const nextRun = cronMatch !== null ? nextCronTime(cronMatch, Date.now()) : null;
 			const cronBad = mode === "scheduled" && (cronMatch === null || nextRun === null);
 			const valid = title.trim().length > 0 && workspaceId !== "" && !cronBad;
+			const runBlocked = editing && task.status === "in_progress";
 			const submit = () => {
 				if (!valid) return;
 				const picked = model !== "" ? JSON.parse(model) : void 0;
@@ -1537,6 +1578,40 @@ window.__ModuleLoader__.load({
 					model: picked
 				});
 			};
+			/** Save the form, then immediately trigger a manual run of the task. */
+			const submitAndRun = () => {
+				if (!valid || runBlocked) return;
+				const picked = model !== "" ? JSON.parse(model) : void 0;
+				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
+					})) 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
+					});
+					if (id !== void 0) await controller.run(id);
+				})();
+			};
 			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", {
 				className: "dsh-atb-modal-backdrop",
@@ -1727,19 +1802,30 @@ window.__ModuleLoader__.load({
 								children: hint
 							}), /* @__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.closeForm(),
-									children: "取消"
-								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-									type: "button",
-									className: "dsh-atb-btn",
-									"data-primary": "true",
-									disabled: !valid,
-									onClick: submit,
-									children: editing ? "保存修改" : "创建任务"
-								})]
+								children: [
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: "dsh-atb-btn",
+										onClick: () => controller.closeForm(),
+										children: "取消"
+									}),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: "dsh-atb-btn",
+										disabled: !valid || runBlocked,
+										title: runBlocked ? "任务正在执行中，不能重复发起" : "保存后立即发起执行（新会话）",
+										onClick: submitAndRun,
+										children: "⚡ 立即执行"
+									}),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: "dsh-atb-btn",
+										"data-primary": "true",
+										disabled: !valid,
+										onClick: submit,
+										children: editing ? "保存修改" : "创建任务"
+									})
+								]
 							})]
 						})
 					]
@@ -1747,6 +1833,62 @@ window.__ModuleLoader__.load({
 			});
 		}
 
+		//#endregion
+		//#region src/client/board/AlertModal.tsx
+		/**
+		* A lightweight alert modal — replaces native alert() with a themed overlay
+		* that matches the shell design tokens.
+		*
+		* @module dsh-taskboard/client/board/AlertModal
+		*/
+		/** Show a non-blocking alert modal. Returns true when opened. */
+		function useAlert() {
+			const [msg, setMsg] = (0, react.useState)(null);
+			const show = (m) => setMsg(m);
+			const close = () => setMsg(null);
+			return {
+				alert: show,
+				el: msg !== null ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(AlertModal, {
+					message: msg,
+					onClose: close
+				}) : null
+			};
+		}
+		function AlertModal({ message, onClose }) {
+			(0, react.useEffect)(() => {
+				const handler = (e) => {
+					if (e.key === "Escape") onClose();
+				};
+				window.addEventListener("keydown", handler);
+				return () => window.removeEventListener("keydown", handler);
+			}, [onClose]);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				className: "dsh-atb-alert-backdrop",
+				onClick: onClose,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					className: "dsh-atb-alert",
+					onClick: (e) => e.stopPropagation(),
+					children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "dsh-atb-alert-icon",
+							children: "⛔"
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "dsh-atb-alert-msg",
+							children: message
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+							type: "button",
+							className: "dsh-atb-btn",
+							"data-primary": "true",
+							onClick: onClose,
+							children: "知道了"
+						})
+					]
+				})
+			});
+		}
+
 		//#endregion
 		//#region src/client/board/TaskBoard.tsx
 		/**
@@ -1765,8 +1907,6 @@ window.__ModuleLoader__.load({
 			canceled: "已取消",
 			archived: "已归档"
 		};
-		/** The two columns between which cards may be dragged both ways. */
-		const DRAGGABLE_STATUSES = /* @__PURE__ */ new Set(["backlog", "todo"]);
 		/** Urgency chip labels. */
 		const URGENCY_LABELS = {
 			urgent: "紧急",
@@ -1792,6 +1932,7 @@ window.__ModuleLoader__.load({
 			const state = (0, react.useSyncExternalStore)((cb) => controller.subscribe(cb), () => controller.getSnapshot());
 			const live = filterTasks(state, state.ledger.tasks.filter((t) => t.trashedAt === void 0));
 			const selected = state.selectedId === void 0 ? void 0 : state.ledger.tasks.find((t) => t.id === state.selectedId);
+			const { alert: showAlert, el: alertEl } = useAlert();
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "dsh-atb-board",
 				children: [
@@ -1810,6 +1951,13 @@ window.__ModuleLoader__.load({
 									state.ledger.revision
 								]
 							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: "dsh-atb-btn",
+								"data-primary": "true",
+								onClick: () => controller.setComposer(true),
+								children: "+ 新建任务"
+							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { className: "dsh-atb-spacer" }),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("select", {
 								className: "dsh-atb-select",
@@ -1843,13 +1991,6 @@ window.__ModuleLoader__.load({
 								className: "dsh-atb-btn",
 								onClick: () => controller.toggleSecondary(),
 								children: state.secondaryOpen ? "返回看板" : "其它任务"
-							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-								type: "button",
-								className: "dsh-atb-btn",
-								"data-primary": "true",
-								onClick: () => controller.setComposer(true),
-								children: "+ 新建任务"
 							})
 						]
 					}),
@@ -1864,28 +2005,31 @@ window.__ModuleLoader__.load({
 						className: "dsh-atb-columns",
 						children: MAIN_STATUSES.map((status) => {
 							const columnTasks = live.filter((t) => t.status === status);
-							const dropTarget = DRAGGABLE_STATUSES.has(status);
 							return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 								className: "dsh-atb-column",
-								onDragOver: dropTarget ? (e) => {
+								onDragOver: (e) => {
 									if (e.dataTransfer.types.includes("application/x-dsh-atb-task")) {
 										e.preventDefault();
 										e.dataTransfer.dropEffect = "move";
 										e.currentTarget.dataset.dragover = "true";
 									}
-								} : void 0,
-								onDragLeave: dropTarget ? (e) => {
+								},
+								onDragLeave: (e) => {
 									delete e.currentTarget.dataset.dragover;
-								} : void 0,
-								onDrop: dropTarget ? (e) => {
+								},
+								onDrop: (e) => {
 									e.preventDefault();
 									delete e.currentTarget.dataset.dragover;
 									const id = e.dataTransfer.getData(DRAG_TYPE);
 									if (id.length === 0) return;
 									const task = state.ledger.tasks.find((t) => t.id === id);
 									if (task === void 0 || task.status === status) return;
+									if (!canTransition(task.status, status)) {
+										showAlert(`无法从「${COLUMN_LABELS[task.status]}」拖至「${COLUMN_LABELS[status]}」`);
+										return;
+									}
 									controller.move(id, task.version, status);
-								} : void 0,
+								},
 								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 									className: "dsh-atb-colhead",
 									children: [COLUMN_LABELS[status], /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
@@ -1897,7 +2041,8 @@ window.__ModuleLoader__.load({
 									children: [columnTasks.map((task) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(TaskCard, {
 										task,
 										controller,
-										draggable: dropTarget
+										draggable: true,
+										onAlert: showAlert
 									}, task.id)), columnTasks.length === 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 										className: "dsh-atb-empty",
 										children: "无任务"
@@ -1916,7 +2061,8 @@ window.__ModuleLoader__.load({
 					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)
-					})
+					}),
+					alertEl
 				]
 			});
 		}