dsh-taskboard 0.1.0 → 0.1.2

package/lib/host/execution.js

@@ -126,6 +126,9 @@ var ExecutionService = class {
 			};
 		}
 		await this.deps.workspaces.attach(task.workspaceId, sessionId).catch(() => {});
+		try {
+			this.deps.renameSession?.(sessionId, task.title);
+		} catch {}
 		await this.patchExecution(executionId, { sessionId });
 		const message = {
 			id: this.deps.mintMessageId?.() ?? MessageId(`msg-taskboard-${crypto.randomUUID()}`),
@@ -134,10 +137,7 @@ var ExecutionService = class {
 				type: "text",
 				text: this.executionPrompt(task)
 			}],
-			source: {
-				kind: "plugin",
-				plugin: "dsh-taskboard"
-			}
+			source: { kind: "user" }
 		};
 		handle.agent.followup(message);
 		const settle = () => {
@@ -166,10 +166,9 @@ var ExecutionService = class {
 	}
 	/** The prompt text one execution submits (task context + instructions). */
 	executionPrompt(task) {
-		const head = `【任务看板执行】${task.title}（任务 ID: ${task.id}）`;
 		const state = "本任务由执行服务启动本会话并已置为 in_progress（你无需再认领，也无需移到 done）。";
 		const tail = `完成后请：1) 用 taskboard_get 读取任务 ${task.id} 拿最新 version；2) 用 taskboard_comment_add 留评论（做了什么改动、如何验证、剩余风险）；3) 用 taskboard_move 把任务 ${task.id} 移到 in_review（带 ifVersion）。`;
-		return `${head}\n\n${state}\n\n${effectivePrompt(task)}\n\n${tail}`;
+		return `【任务】${task.title}（任务 ID: ${task.id}）\n\n${state}\n\n${effectivePrompt(task)}\n\n${tail}`;
 	}
 	/** Move a task back out of in_progress after a failed start. */
 	async revertProgress(taskId) {

package/lib/host/execution.js.map

@@ -1 +1 @@
-{"version":3,"file":"execution.js","names":[],"sources":["../../src/host/execution.ts"],"sourcesContent":["/**\n * Host execution service: runs a task through dsh's REAL session machinery —\n * a fresh agent+session inside the task's project workspace (creation carries\n * the pinned model when the task has one), the session is attached to the\n * workspace so it appears in the GUI's project session list, the effective\n * prompt is submitted as an ordinary user message, and the turn settlement\n * (turn/end reason) is folded back into the task's execution record.\n *\n * Every execution is a NEW session: clean context, no reuse of previous runs.\n *\n * @module dsh-taskboard/host/execution\n */\nimport { effectivePrompt, newExecutionId, type ExecutionRecord, type TaskRecord } from '../shared/protocol.ts'\nimport { MessageId } from './sdk.ts'\nimport type { TaskStore } from './store.ts'\n\n/** Narrow agents face (the registry's create, structurally). */\nexport interface AgentsFace {\n  create(options: {\n    sessionId: string\n    meta?: { cwd?: string }\n    agentOptions?: { provider?: string; model?: string }\n  }): Promise<{\n    agent: {\n      id: string\n      followup(message: unknown): void\n      whenIdle(): Promise<void>\n    }\n    dispose(): Promise<void>\n  }>\n}\n\n/** Narrow workspaces face for execution. */\nexport interface ExecutionWorkspaceFace {\n  get(id: string): { id: string; path: string } | undefined\n  attach(workspaceId: string, sessionId: string): Promise<void>\n}\n\n/** Narrow event-bus face for settlement listening. */\nexport interface EventsFace {\n  onSessionEvent(listener: (sessionId: string, event: { type: string; data?: unknown }) => void): () => void\n}\n\n/** Everything the execution service needs. */\nexport interface ExecutionDeps {\n  store: TaskStore\n  agents: AgentsFace\n  workspaces: ExecutionWorkspaceFace\n  events: EventsFace\n  now: () => number\n  /** The deployment default model (fills sessions of unpinned tasks). */\n  defaultModel?: () => { provider: string; model: string } | undefined\n  /** Mint session ids (injectable for tests). */\n  mintSessionId?: () => string\n  /** Mint message ids (injectable for tests). */\n  mintMessageId?: () => string\n}\n\n/** Outcome of a run request (immediate; the run settles asynchronously). */\nexport type RunRequestResult =\n  | { ok: true; executionId: string; sessionId: string }\n  | { ok: false; error: string }\n\n/** Whether a turn/end payload closed with an error reason. */\nfunction isErrorTurnEnd(data: unknown): { message: string } | undefined {\n  if (typeof data !== 'object' || data === null) return undefined\n  const reason = (data as { reason?: unknown }).reason\n  if (typeof reason !== 'object' || reason === null) return undefined\n  const kind = (reason as { kind?: unknown }).kind\n  if (kind !== 'error') return undefined\n  const error = (reason as { error?: { message?: unknown } }).error\n  const detail = JSON.stringify(error) ?? ''\n  const message = typeof error?.message === 'string' ? error.message : 'turn failed'\n  console.error('[dsh-taskboard] turn error detail:', detail.slice(0, 2000))\n  void detail\n  return { message }\n}\n\n/**\n * The execution service.\n */\nexport class ExecutionService {\n  /** Execution ids currently settling. */\n  private readonly settling = new Map<string, () => void>()\n\n  /** @param deps - store + agents + workspaces + events + clock. */\n  constructor(private readonly deps: ExecutionDeps) {\n    deps.events.onSessionEvent((sessionId, event) => {\n      if (event.type !== 'turn/end') return\n      const failure = isErrorTurnEnd(event.data)\n      if (failure !== undefined) this.noteFailure(sessionId, failure.message)\n    })\n  }\n\n  /** Record a turn failure against the running execution of that session. */\n  private noteFailure(sessionId: string, message: string): void {\n    void this.deps.store.mutate('execution-recorded', (ledger) => {\n      for (const task of ledger.tasks) {\n        for (const execution of task.executions) {\n          if (execution.sessionId === sessionId && execution.outcome === 'running') {\n            execution.outcome = 'failed'\n            execution.error = message.slice(0, 500)\n            execution.endedAt = this.deps.now()\n            return [task]\n          }\n        }\n      }\n      return undefined\n    })\n  }\n\n  /** Patch one task's execution record in the ledger. */\n  private async patchExecution(executionId: string, patch: Partial<ExecutionRecord>): Promise<void> {\n    await this.deps.store.mutate('execution-recorded', (ledger) => {\n      for (const task of ledger.tasks) {\n        const execution = task.executions.find(e => e.id === executionId)\n        if (execution !== undefined) {\n          Object.assign(execution, patch)\n          return [task]\n        }\n      }\n      return undefined\n    })\n  }\n\n  /**\n   * Run one task now (manual button or scheduler tick).\n   * @param taskId - the task to run.\n   * @param trigger - what started it.\n   * @returns the immediate result; settlement lands in the ledger.\n   */\n  async run(taskId: string, trigger: ExecutionRecord['trigger']): Promise<RunRequestResult> {\n    const task = this.deps.store.get(taskId)\n    if (task === undefined || task.trashedAt !== undefined) {\n      return { ok: false, error: `no task ${taskId}` }\n    }\n    if (task.status === 'in_progress') {\n      return { ok: false, error: 'task is already in progress' }\n    }\n    const workspace = this.deps.workspaces.get(task.workspaceId)\n    if (workspace === undefined) {\n      return { ok: false, error: `unknown workspace ${task.workspaceId}` }\n    }\n\n    const executionId = newExecutionId()\n    const sessionId = this.deps.mintSessionId?.() ?? `session-taskboard-${crypto.randomUUID()}`\n\n    // 1. Open the execution record and move the card to in_progress in one write.\n    await this.deps.store.mutate('execution-recorded', (ledger) => {\n      const target = ledger.tasks.find(t => t.id === taskId)\n      if (target === undefined) return undefined\n      target.executions.push({\n        id: executionId,\n        trigger,\n        startedAt: this.deps.now(),\n        outcome: 'running',\n      })\n      target.status = 'in_progress'\n      target.updatedAt = this.deps.now()\n      target.updatedBy = { kind: 'user' }\n      return [target]\n    })\n\n    // 2. Create the fresh agent+session inside the task's project, carrying\n    //    the pinned model — or the deployment default when unpinned (the\n    //    persona template renders {{model}}, so the session always needs one).\n    let handle: Awaited<ReturnType<AgentsFace['create']>>\n    try {\n      const model = task.model ?? this.deps.defaultModel?.()\n      handle = await this.deps.agents.create({\n        sessionId,\n        meta: { cwd: workspace.path },\n        ...(model !== undefined ? { agentOptions: { provider: model.provider, model: model.model } } : {}),\n      })\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error)\n      await this.patchExecution(executionId, { outcome: 'failed', error: message.slice(0, 500), endedAt: this.deps.now() })\n      await this.revertProgress(taskId)\n      return { ok: false, error: message }\n    }\n\n    // 3. Attach the session to the workspace (GUI project session list).\n    await this.deps.workspaces.attach(task.workspaceId, sessionId).catch(() => { /* cosmetic */ })\n\n    // 4. Record the session id (execution is really started now).\n    await this.patchExecution(executionId, { sessionId })\n\n    // 5. Submit the effective prompt as an ordinary user message and settle\n    //    on quiescence (turn/end errors were already folded by the listener).\n    const message = {\n      id: this.deps.mintMessageId?.() ?? MessageId(`msg-taskboard-${crypto.randomUUID()}`),\n      role: 'user' as const,\n      content: [{ type: 'text' as const, text: this.executionPrompt(task) }],\n      source: { kind: 'plugin' as const, plugin: 'dsh-taskboard' },\n    }\n    handle.agent.followup(message)\n\n    // 6. Settlement watcher.\n    const settle = (): void => {\n      this.settling.delete(executionId)\n      void this.deps.store.mutate('execution-recorded', (ledger) => {\n        for (const t of ledger.tasks) {\n          const execution = t.executions.find(e => e.id === executionId)\n          if (execution !== undefined && execution.outcome === 'running') {\n            execution.outcome = 'succeeded'\n            execution.endedAt = this.deps.now()\n            return [t]\n          }\n        }\n        return undefined\n      })\n    }\n    this.settling.set(executionId, settle)\n    void handle.agent.whenIdle().then(settle, () => {\n      this.noteFailure(sessionId, 'agent did not reach quiescence')\n      settle()\n    })\n\n    return { ok: true, executionId, sessionId }\n  }\n\n  /** The prompt text one execution submits (task context + instructions). */\n  private executionPrompt(task: TaskRecord): string {\n    const head = `【任务看板执行】${task.title}（任务 ID: ${task.id}）`\n    const state = '本任务由执行服务启动本会话并已置为 in_progress（你无需再认领，也无需移到 done）。'\n    const tail = `完成后请：1) 用 taskboard_get 读取任务 ${task.id} 拿最新 version；`\n      + `2) 用 taskboard_comment_add 留评论（做了什么改动、如何验证、剩余风险）；`\n      + `3) 用 taskboard_move 把任务 ${task.id} 移到 in_review（带 ifVersion）。`\n    return `${head}\\n\\n${state}\\n\\n${effectivePrompt(task)}\\n\\n${tail}`\n  }\n\n  /** Move a task back out of in_progress after a failed start. */\n  private async revertProgress(taskId: string): Promise<void> {\n    await this.deps.store.mutate('execution-recorded', (ledger) => {\n      const target = ledger.tasks.find(t => t.id === taskId)\n      if (target !== undefined && target.status === 'in_progress') {\n        target.status = 'todo'\n        target.updatedAt = this.deps.now()\n        return [target]\n      }\n      return undefined\n    })\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"execution.js","names":[],"sources":["../../src/host/execution.ts"],"sourcesContent":["/**\n * Host execution service: runs a task through dsh's REAL session machinery —\n * a fresh agent+session inside the task's project workspace (creation carries\n * the pinned model when the task has one), the session is attached to the\n * workspace so it appears in the GUI's project session list, the effective\n * prompt is submitted as an ordinary user message, and the turn settlement\n * (turn/end reason) is folded back into the task's execution record.\n *\n * Every execution is a NEW session: clean context, no reuse of previous runs.\n *\n * @module dsh-taskboard/host/execution\n */\nimport { effectivePrompt, newExecutionId, type ExecutionRecord, type TaskRecord } from '../shared/protocol.ts'\nimport { MessageId } from './sdk.ts'\nimport type { TaskStore } from './store.ts'\n\n/** Narrow agents face (the registry's create, structurally). */\nexport interface AgentsFace {\n  create(options: {\n    sessionId: string\n    meta?: { cwd?: string }\n    agentOptions?: { provider?: string; model?: string }\n  }): Promise<{\n    agent: {\n      id: string\n      followup(message: unknown): void\n      whenIdle(): Promise<void>\n    }\n    dispose(): Promise<void>\n  }>\n}\n\n/** Narrow workspaces face for execution. */\nexport interface ExecutionWorkspaceFace {\n  get(id: string): { id: string; path: string } | undefined\n  attach(workspaceId: string, sessionId: string): Promise<void>\n}\n\n/** Narrow event-bus face for settlement listening. */\nexport interface EventsFace {\n  onSessionEvent(listener: (sessionId: string, event: { type: string; data?: unknown }) => void): () => void\n}\n\n/** Everything the execution service needs. */\nexport interface ExecutionDeps {\n  store: TaskStore\n  agents: AgentsFace\n  workspaces: ExecutionWorkspaceFace\n  events: EventsFace\n  now: () => number\n  /** The deployment default model (fills sessions of unpinned tasks). */\n  defaultModel?: () => { provider: string; model: string } | undefined\n  /** Mint session ids (injectable for tests). */\n  mintSessionId?: () => string\n  /** Mint message ids (injectable for tests). */\n  mintMessageId?: () => string\n  /** Best-effort session rename (pins the session list title to the task title). */\n  renameSession?: (sessionId: string, title: string) => void\n}\n\n/** Outcome of a run request (immediate; the run settles asynchronously). */\nexport type RunRequestResult =\n  | { ok: true; executionId: string; sessionId: string }\n  | { ok: false; error: string }\n\n/** Whether a turn/end payload closed with an error reason. */\nfunction isErrorTurnEnd(data: unknown): { message: string } | undefined {\n  if (typeof data !== 'object' || data === null) return undefined\n  const reason = (data as { reason?: unknown }).reason\n  if (typeof reason !== 'object' || reason === null) return undefined\n  const kind = (reason as { kind?: unknown }).kind\n  if (kind !== 'error') return undefined\n  const error = (reason as { error?: { message?: unknown } }).error\n  const detail = JSON.stringify(error) ?? ''\n  const message = typeof error?.message === 'string' ? error.message : 'turn failed'\n  console.error('[dsh-taskboard] turn error detail:', detail.slice(0, 2000))\n  void detail\n  return { message }\n}\n\n/**\n * The execution service.\n */\nexport class ExecutionService {\n  /** Execution ids currently settling. */\n  private readonly settling = new Map<string, () => void>()\n\n  /** @param deps - store + agents + workspaces + events + clock. */\n  constructor(private readonly deps: ExecutionDeps) {\n    deps.events.onSessionEvent((sessionId, event) => {\n      if (event.type !== 'turn/end') return\n      const failure = isErrorTurnEnd(event.data)\n      if (failure !== undefined) this.noteFailure(sessionId, failure.message)\n    })\n  }\n\n  /** Record a turn failure against the running execution of that session. */\n  private noteFailure(sessionId: string, message: string): void {\n    void this.deps.store.mutate('execution-recorded', (ledger) => {\n      for (const task of ledger.tasks) {\n        for (const execution of task.executions) {\n          if (execution.sessionId === sessionId && execution.outcome === 'running') {\n            execution.outcome = 'failed'\n            execution.error = message.slice(0, 500)\n            execution.endedAt = this.deps.now()\n            return [task]\n          }\n        }\n      }\n      return undefined\n    })\n  }\n\n  /** Patch one task's execution record in the ledger. */\n  private async patchExecution(executionId: string, patch: Partial<ExecutionRecord>): Promise<void> {\n    await this.deps.store.mutate('execution-recorded', (ledger) => {\n      for (const task of ledger.tasks) {\n        const execution = task.executions.find(e => e.id === executionId)\n        if (execution !== undefined) {\n          Object.assign(execution, patch)\n          return [task]\n        }\n      }\n      return undefined\n    })\n  }\n\n  /**\n   * Run one task now (manual button or scheduler tick).\n   * @param taskId - the task to run.\n   * @param trigger - what started it.\n   * @returns the immediate result; settlement lands in the ledger.\n   */\n  async run(taskId: string, trigger: ExecutionRecord['trigger']): Promise<RunRequestResult> {\n    const task = this.deps.store.get(taskId)\n    if (task === undefined || task.trashedAt !== undefined) {\n      return { ok: false, error: `no task ${taskId}` }\n    }\n    if (task.status === 'in_progress') {\n      return { ok: false, error: 'task is already in progress' }\n    }\n    const workspace = this.deps.workspaces.get(task.workspaceId)\n    if (workspace === undefined) {\n      return { ok: false, error: `unknown workspace ${task.workspaceId}` }\n    }\n\n    const executionId = newExecutionId()\n    const sessionId = this.deps.mintSessionId?.() ?? `session-taskboard-${crypto.randomUUID()}`\n\n    // 1. Open the execution record and move the card to in_progress in one write.\n    await this.deps.store.mutate('execution-recorded', (ledger) => {\n      const target = ledger.tasks.find(t => t.id === taskId)\n      if (target === undefined) return undefined\n      target.executions.push({\n        id: executionId,\n        trigger,\n        startedAt: this.deps.now(),\n        outcome: 'running',\n      })\n      target.status = 'in_progress'\n      target.updatedAt = this.deps.now()\n      target.updatedBy = { kind: 'user' }\n      return [target]\n    })\n\n    // 2. Create the fresh agent+session inside the task's project, carrying\n    //    the pinned model — or the deployment default when unpinned (the\n    //    persona template renders {{model}}, so the session always needs one).\n    let handle: Awaited<ReturnType<AgentsFace['create']>>\n    try {\n      const model = task.model ?? this.deps.defaultModel?.()\n      handle = await this.deps.agents.create({\n        sessionId,\n        meta: { cwd: workspace.path },\n        ...(model !== undefined ? { agentOptions: { provider: model.provider, model: model.model } } : {}),\n      })\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error)\n      await this.patchExecution(executionId, { outcome: 'failed', error: message.slice(0, 500), endedAt: this.deps.now() })\n      await this.revertProgress(taskId)\n      return { ok: false, error: message }\n    }\n\n    // 3. Attach the session to the workspace (GUI project session list).\n    await this.deps.workspaces.attach(task.workspaceId, sessionId).catch(() => { /* cosmetic */ })\n\n    // 3b. Best-effort rename: pin the session title to the task title so the\n    //     session list shows the task name (a user-sourced title also stops\n    //     automatic first-prompt retitling).\n    try {\n      this.deps.renameSession?.(sessionId, task.title)\n    } catch { /* cosmetic */ }\n\n    // 4. Record the session id (execution is really started now).\n    await this.patchExecution(executionId, { sessionId })\n\n    // 5. Submit the effective prompt as an ordinary user message and settle\n    //    on quiescence (turn/end errors were already folded by the listener).\n    //    Source `user` (not `plugin`) so the opening message renders as a\n    //    normal user bubble in the conversation, exactly like a typed prompt.\n    const message = {\n      id: this.deps.mintMessageId?.() ?? MessageId(`msg-taskboard-${crypto.randomUUID()}`),\n      role: 'user' as const,\n      content: [{ type: 'text' as const, text: this.executionPrompt(task) }],\n      source: { kind: 'user' as const },\n    }\n    handle.agent.followup(message)\n\n    // 6. Settlement watcher.\n    const settle = (): void => {\n      this.settling.delete(executionId)\n      void this.deps.store.mutate('execution-recorded', (ledger) => {\n        for (const t of ledger.tasks) {\n          const execution = t.executions.find(e => e.id === executionId)\n          if (execution !== undefined && execution.outcome === 'running') {\n            execution.outcome = 'succeeded'\n            execution.endedAt = this.deps.now()\n            return [t]\n          }\n        }\n        return undefined\n      })\n    }\n    this.settling.set(executionId, settle)\n    void handle.agent.whenIdle().then(settle, () => {\n      this.noteFailure(sessionId, 'agent did not reach quiescence')\n      settle()\n    })\n\n    return { ok: true, executionId, sessionId }\n  }\n\n  /** The prompt text one execution submits (task context + instructions). */\n  private executionPrompt(task: TaskRecord): string {\n    const state = '本任务由执行服务启动本会话并已置为 in_progress（你无需再认领，也无需移到 done）。'\n    const tail = `完成后请：1) 用 taskboard_get 读取任务 ${task.id} 拿最新 version；`\n      + `2) 用 taskboard_comment_add 留评论（做了什么改动、如何验证、剩余风险）；`\n      + `3) 用 taskboard_move 把任务 ${task.id} 移到 in_review（带 ifVersion）。`\n    return `【任务】${task.title}（任务 ID: ${task.id}）\\n\\n${state}\\n\\n${effectivePrompt(task)}\\n\\n${tail}`\n  }\n\n  /** Move a task back out of in_progress after a failed start. */\n  private async revertProgress(taskId: string): Promise<void> {\n    await this.deps.store.mutate('execution-recorded', (ledger) => {\n      const target = ledger.tasks.find(t => t.id === taskId)\n      if (target !== undefined && target.status === 'in_progress') {\n        target.status = 'todo'\n        target.updatedAt = this.deps.now()\n        return [target]\n      }\n      return undefined\n    })\n  }\n}\n"],"mappings":"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"}

package/lib/index.js

@@ -48,6 +48,14 @@ function apply(ctx) {
 				},
 				events,
 				now,
+				renameSession: (sessionId, title) => {
+					try {
+						const sessions = agentCtx.get("sessions");
+						const sessionTitle = agentCtx.get("sessionTitle");
+						const session = sessions?.get(sessionId);
+						if (session !== void 0 && sessionTitle !== void 0) sessionTitle.rename(session, title);
+					} catch {}
+				},
 				defaultModel: () => {
 					try {
 						const selection = agentCtx.get("agentDefaultModel");

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * Host loader entry for dsh-taskboard.\n *\n * Wiring: the ledger store (one JSON file under the DSH home), the eight\n * `taskboard_*` agent tools, the agent workflow-protocol system-prompt\n * section, the /taskboard JSON+SSE routes (when a webServer is served),\n * the host execution service (fresh in-project sessions, pinned models), and\n * the host-side cron scheduler for scheduled tasks.\n *\n * Export shape follows the dsh-tool-todo lesson: a function/namespace plugin —\n * `name` / `inject` / `apply`, NO default export.\n *\n * @module dsh-taskboard\n */\nimport type { Context } from '@deepseek-ai/cordis'\n// Type-only module imports: they load the cordis Context augmentations\n// (ctx.tools / ctx.systemPrompt / ctx.agents) and vanish at compile time —\n// the built host half keeps ZERO runtime @deepseek-ai imports.\nimport type {} from '@deepseek-ai/dsh-tools'\nimport type {} from '@deepseek-ai/dsh-system-prompt'\nimport type {} from '@deepseek-ai/dsh-agent'\nimport { PROTOCOL_SECTION_NAME, PROTOCOL_SECTION_ORDER, TASKBOARD_PROTOCOL } from './host/protocol-text.ts'\nimport { ExecutionService, type EventsFace } from './host/execution.ts'\nimport { registerTaskboardRoutes } from './host/routes.ts'\nimport { SchedulerService } from './host/scheduler.ts'\nimport { dshHomePath } from './host/sdk.ts'\nimport { TaskStore } from './host/store.ts'\nimport { registerTaskboardTools, workspaceFace } from './host/tools.ts'\n\n/** Ledger file name under the DSH home. */\nexport const LEDGER_FILE = 'dsh-taskboard.json'\n\n/** Cordis plugin name. */\nexport const name = 'dsh-taskboard'\n\n/** Required host services (tool registry + prompt assembly). */\nexport const inject = ['tools', 'systemPrompt']\n\n/**\n * Mount the host half.\n * @param ctx - the plugin context (tools + systemPrompt injected).\n */\nexport function apply(ctx: Context): void {\n  const store = new TaskStore({ file: dshHomePath(LEDGER_FILE) })\n  const now = () => Date.now()\n\n  // Agent workflow protocol (claim discipline, retry rules, done-gate).\n  const disposeSection = ctx.systemPrompt.section({\n    name: PROTOCOL_SECTION_NAME,\n    order: PROTOCOL_SECTION_ORDER,\n    text: TASKBOARD_PROTOCOL,\n  })\n  ctx.effect(() => disposeSection, 'dsh-taskboard: protocol section')\n\n  // Tools, routes, execution, and the scheduler all come up with the\n  // workspace registry (claim boundary + project execution need it).\n  ctx.inject(['workspaceRegistry'], (wsCtx: Context) => {\n    const disposers: Array<() => void> = []\n    disposers.push(...registerTaskboardTools(wsCtx, {\n      store,\n      workspaces: workspaceFace(wsCtx.workspaceRegistry),\n      now,\n    }))\n\n    // Settlement listener over the session event bus.\n    const events: EventsFace = {\n      onSessionEvent: (listener) => wsCtx.on('session/event', (session, event) => {\n        listener(session.id, event as { type: string; data?: unknown })\n      }),\n    }\n\n    wsCtx.inject(['agents'], (agentCtx: Context) => {\n      const execution = new ExecutionService({\n        store,\n        agents: {\n          create: (options): Promise<never> => agentCtx.agents.create(options as never) as Promise<never>,\n        },\n        workspaces: {\n          get: id => workspaceFace(wsCtx.workspaceRegistry).get(id),\n          attach: async (workspaceId, sessionId) => {\n            const ws = wsCtx.workspaceRegistry.get(workspaceId as never)\n            if (ws !== undefined) await ws.attachSession(sessionId as never)\n          },\n        },\n        events,\n        now,\n        defaultModel: () => {\n          try {\n            const selection = agentCtx.get('agentDefaultModel') as { currentSelection?: () => { provider: string; model: string } | undefined } | undefined\n            const read = selection?.currentSelection\n            return read === undefined ? undefined : read.call(selection)\n          } catch { return undefined }\n        },\n      })\n\n      // /dsh-taskboard routes (the run action reaches the execution service).\n      let disposeRoutes: (() => void) | undefined\n      agentCtx.inject(['webServer'], (webCtx: Context) => {\n        disposeRoutes = registerTaskboardRoutes(webCtx, {\n          store,\n          workspaces: workspaceFace(wsCtx.workspaceRegistry),\n          now,\n          run: (taskId: string) => execution.run(taskId, 'manual'),\n        })\n        return () => disposeRoutes?.()\n      })\n\n      // Host-side cron scheduler: due scheduled tasks execute even with no\n      // browser open.\n      const scheduler = new SchedulerService({ store, execution, now })\n      scheduler.start()\n      disposers.push(() => scheduler.dispose())\n\n      return () => {\n        disposeRoutes?.()\n        for (const dispose of disposers.splice(0)) dispose()\n      }\n    })\n\n    return () => {\n      for (const dispose of disposers.splice(0)) dispose()\n    }\n  })\n}\n"],"mappings":";;;;;;;;;AA8BA,MAAa,cAAc;;AAG3B,MAAa,OAAO;;AAGpB,MAAa,SAAS,CAAC,SAAS,cAAc;;;;;AAM9C,SAAgB,MAAM,KAAoB;CACxC,MAAM,QAAQ,IAAI,UAAU,EAAE,MAAM,YAAY,WAAW,EAAE,CAAC;CAC9D,MAAM,YAAY,KAAK,IAAI;CAG3B,MAAM,iBAAiB,IAAI,aAAa,QAAQ;EAC9C,MAAM;EACN,OAAA;EACA,MAAM;CACR,CAAC;CACD,IAAI,aAAa,gBAAgB,iCAAiC;CAIlE,IAAI,OAAO,CAAC,mBAAmB,IAAI,UAAmB;EACpD,MAAM,YAA+B,CAAC;EACtC,UAAU,KAAK,GAAG,uBAAuB,OAAO;GAC9C;GACA,YAAY,cAAc,MAAM,iBAAiB;GACjD;EACF,CAAC,CAAC;EAGF,MAAM,SAAqB,EACzB,iBAAiB,aAAa,MAAM,GAAG,kBAAkB,SAAS,UAAU;GAC1E,SAAS,QAAQ,IAAI,KAAyC;EAChE,CAAC,EACH;EAEA,MAAM,OAAO,CAAC,QAAQ,IAAI,aAAsB;GAC9C,MAAM,YAAY,IAAI,iBAAiB;IACrC;IACA,QAAQ,EACN,SAAS,YAA4B,SAAS,OAAO,OAAO,OAAgB,EAC9E;IACA,YAAY;KACV,MAAK,OAAM,cAAc,MAAM,iBAAiB,CAAC,CAAC,IAAI,EAAE;KACxD,QAAQ,OAAO,aAAa,cAAc;MACxC,MAAM,KAAK,MAAM,kBAAkB,IAAI,WAAoB;MAC3D,IAAI,OAAO,KAAA,GAAW,MAAM,GAAG,cAAc,SAAkB;KACjE;IACF;IACA;IACA;IACA,oBAAoB;KAClB,IAAI;MACF,MAAM,YAAY,SAAS,IAAI,mBAAmB;MAClD,MAAM,OAAO,WAAW;MACxB,OAAO,SAAS,KAAA,IAAY,KAAA,IAAY,KAAK,KAAK,SAAS;KAC7D,QAAQ;MAAE;KAAiB;IAC7B;GACF,CAAC;GAGD,IAAI;GACJ,SAAS,OAAO,CAAC,WAAW,IAAI,WAAoB;IAClD,gBAAgB,wBAAwB,QAAQ;KAC9C;KACA,YAAY,cAAc,MAAM,iBAAiB;KACjD;KACA,MAAM,WAAmB,UAAU,IAAI,QAAQ,QAAQ;IACzD,CAAC;IACD,aAAa,gBAAgB;GAC/B,CAAC;GAID,MAAM,YAAY,IAAI,iBAAiB;IAAE;IAAO;IAAW;GAAI,CAAC;GAChE,UAAU,MAAM;GAChB,UAAU,WAAW,UAAU,QAAQ,CAAC;GAExC,aAAa;IACX,gBAAgB;IAChB,KAAK,MAAM,WAAW,UAAU,OAAO,CAAC,GAAG,QAAQ;GACrD;EACF,CAAC;EAED,aAAa;GACX,KAAK,MAAM,WAAW,UAAU,OAAO,CAAC,GAAG,QAAQ;EACrD;CACF,CAAC;AACH"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * Host loader entry for dsh-taskboard.\n *\n * Wiring: the ledger store (one JSON file under the DSH home), the eight\n * `taskboard_*` agent tools, the agent workflow-protocol system-prompt\n * section, the /taskboard JSON+SSE routes (when a webServer is served),\n * the host execution service (fresh in-project sessions, pinned models), and\n * the host-side cron scheduler for scheduled tasks.\n *\n * Export shape follows the dsh-tool-todo lesson: a function/namespace plugin —\n * `name` / `inject` / `apply`, NO default export.\n *\n * @module dsh-taskboard\n */\nimport type { Context } from '@deepseek-ai/cordis'\n// Type-only module imports: they load the cordis Context augmentations\n// (ctx.tools / ctx.systemPrompt / ctx.agents) and vanish at compile time —\n// the built host half keeps ZERO runtime @deepseek-ai imports.\nimport type {} from '@deepseek-ai/dsh-tools'\nimport type {} from '@deepseek-ai/dsh-system-prompt'\nimport type {} from '@deepseek-ai/dsh-agent'\nimport { PROTOCOL_SECTION_NAME, PROTOCOL_SECTION_ORDER, TASKBOARD_PROTOCOL } from './host/protocol-text.ts'\nimport { ExecutionService, type EventsFace } from './host/execution.ts'\nimport { registerTaskboardRoutes } from './host/routes.ts'\nimport { SchedulerService } from './host/scheduler.ts'\nimport { dshHomePath } from './host/sdk.ts'\nimport { TaskStore } from './host/store.ts'\nimport { registerTaskboardTools, workspaceFace } from './host/tools.ts'\n\n/** Ledger file name under the DSH home. */\nexport const LEDGER_FILE = 'dsh-taskboard.json'\n\n/** Cordis plugin name. */\nexport const name = 'dsh-taskboard'\n\n/** Required host services (tool registry + prompt assembly). */\nexport const inject = ['tools', 'systemPrompt']\n\n/**\n * Mount the host half.\n * @param ctx - the plugin context (tools + systemPrompt injected).\n */\nexport function apply(ctx: Context): void {\n  const store = new TaskStore({ file: dshHomePath(LEDGER_FILE) })\n  const now = () => Date.now()\n\n  // Agent workflow protocol (claim discipline, retry rules, done-gate).\n  const disposeSection = ctx.systemPrompt.section({\n    name: PROTOCOL_SECTION_NAME,\n    order: PROTOCOL_SECTION_ORDER,\n    text: TASKBOARD_PROTOCOL,\n  })\n  ctx.effect(() => disposeSection, 'dsh-taskboard: protocol section')\n\n  // Tools, routes, execution, and the scheduler all come up with the\n  // workspace registry (claim boundary + project execution need it).\n  ctx.inject(['workspaceRegistry'], (wsCtx: Context) => {\n    const disposers: Array<() => void> = []\n    disposers.push(...registerTaskboardTools(wsCtx, {\n      store,\n      workspaces: workspaceFace(wsCtx.workspaceRegistry),\n      now,\n    }))\n\n    // Settlement listener over the session event bus.\n    const events: EventsFace = {\n      onSessionEvent: (listener) => wsCtx.on('session/event', (session, event) => {\n        listener(session.id, event as { type: string; data?: unknown })\n      }),\n    }\n\n    wsCtx.inject(['agents'], (agentCtx: Context) => {\n      const execution = new ExecutionService({\n        store,\n        agents: {\n          create: (options): Promise<never> => agentCtx.agents.create(options as never) as Promise<never>,\n        },\n        workspaces: {\n          get: id => workspaceFace(wsCtx.workspaceRegistry).get(id),\n          attach: async (workspaceId, sessionId) => {\n            const ws = wsCtx.workspaceRegistry.get(workspaceId as never)\n            if (ws !== undefined) await ws.attachSession(sessionId as never)\n          },\n        },\n        events,\n        now,\n        renameSession: (sessionId, title) => {\n          // Best-effort: pin the execution session's title to the task title\n          // through the log-backed session-title service (user-sourced rename).\n          try {\n            const sessions = agentCtx.get('sessions') as { get(id: string): unknown } | undefined\n            const sessionTitle = agentCtx.get('sessionTitle') as { rename(session: unknown, title: string): unknown } | undefined\n            const session = sessions?.get(sessionId)\n            if (session !== undefined && sessionTitle !== undefined) sessionTitle.rename(session, title)\n          } catch { /* cosmetic */ }\n        },\n        defaultModel: () => {\n          try {\n            const selection = agentCtx.get('agentDefaultModel') as { currentSelection?: () => { provider: string; model: string } | undefined } | undefined\n            const read = selection?.currentSelection\n            return read === undefined ? undefined : read.call(selection)\n          } catch { return undefined }\n        },\n      })\n\n      // /dsh-taskboard routes (the run action reaches the execution service).\n      let disposeRoutes: (() => void) | undefined\n      agentCtx.inject(['webServer'], (webCtx: Context) => {\n        disposeRoutes = registerTaskboardRoutes(webCtx, {\n          store,\n          workspaces: workspaceFace(wsCtx.workspaceRegistry),\n          now,\n          run: (taskId: string) => execution.run(taskId, 'manual'),\n        })\n        return () => disposeRoutes?.()\n      })\n\n      // Host-side cron scheduler: due scheduled tasks execute even with no\n      // browser open.\n      const scheduler = new SchedulerService({ store, execution, now })\n      scheduler.start()\n      disposers.push(() => scheduler.dispose())\n\n      return () => {\n        disposeRoutes?.()\n        for (const dispose of disposers.splice(0)) dispose()\n      }\n    })\n\n    return () => {\n      for (const dispose of disposers.splice(0)) dispose()\n    }\n  })\n}\n"],"mappings":";;;;;;;;;AA8BA,MAAa,cAAc;;AAG3B,MAAa,OAAO;;AAGpB,MAAa,SAAS,CAAC,SAAS,cAAc;;;;;AAM9C,SAAgB,MAAM,KAAoB;CACxC,MAAM,QAAQ,IAAI,UAAU,EAAE,MAAM,YAAY,WAAW,EAAE,CAAC;CAC9D,MAAM,YAAY,KAAK,IAAI;CAG3B,MAAM,iBAAiB,IAAI,aAAa,QAAQ;EAC9C,MAAM;EACN,OAAA;EACA,MAAM;CACR,CAAC;CACD,IAAI,aAAa,gBAAgB,iCAAiC;CAIlE,IAAI,OAAO,CAAC,mBAAmB,IAAI,UAAmB;EACpD,MAAM,YAA+B,CAAC;EACtC,UAAU,KAAK,GAAG,uBAAuB,OAAO;GAC9C;GACA,YAAY,cAAc,MAAM,iBAAiB;GACjD;EACF,CAAC,CAAC;EAGF,MAAM,SAAqB,EACzB,iBAAiB,aAAa,MAAM,GAAG,kBAAkB,SAAS,UAAU;GAC1E,SAAS,QAAQ,IAAI,KAAyC;EAChE,CAAC,EACH;EAEA,MAAM,OAAO,CAAC,QAAQ,IAAI,aAAsB;GAC9C,MAAM,YAAY,IAAI,iBAAiB;IACrC;IACA,QAAQ,EACN,SAAS,YAA4B,SAAS,OAAO,OAAO,OAAgB,EAC9E;IACA,YAAY;KACV,MAAK,OAAM,cAAc,MAAM,iBAAiB,CAAC,CAAC,IAAI,EAAE;KACxD,QAAQ,OAAO,aAAa,cAAc;MACxC,MAAM,KAAK,MAAM,kBAAkB,IAAI,WAAoB;MAC3D,IAAI,OAAO,KAAA,GAAW,MAAM,GAAG,cAAc,SAAkB;KACjE;IACF;IACA;IACA;IACA,gBAAgB,WAAW,UAAU;KAGnC,IAAI;MACF,MAAM,WAAW,SAAS,IAAI,UAAU;MACxC,MAAM,eAAe,SAAS,IAAI,cAAc;MAChD,MAAM,UAAU,UAAU,IAAI,SAAS;MACvC,IAAI,YAAY,KAAA,KAAa,iBAAiB,KAAA,GAAW,aAAa,OAAO,SAAS,KAAK;KAC7F,QAAQ,CAAiB;IAC3B;IACA,oBAAoB;KAClB,IAAI;MACF,MAAM,YAAY,SAAS,IAAI,mBAAmB;MAClD,MAAM,OAAO,WAAW;MACxB,OAAO,SAAS,KAAA,IAAY,KAAA,IAAY,KAAK,KAAK,SAAS;KAC7D,QAAQ;MAAE;KAAiB;IAC7B;GACF,CAAC;GAGD,IAAI;GACJ,SAAS,OAAO,CAAC,WAAW,IAAI,WAAoB;IAClD,gBAAgB,wBAAwB,QAAQ;KAC9C;KACA,YAAY,cAAc,MAAM,iBAAiB;KACjD;KACA,MAAM,WAAmB,UAAU,IAAI,QAAQ,QAAQ;IACzD,CAAC;IACD,aAAa,gBAAgB;GAC/B,CAAC;GAID,MAAM,YAAY,IAAI,iBAAiB;IAAE;IAAO;IAAW;GAAI,CAAC;GAChE,UAAU,MAAM;GAChB,UAAU,WAAW,UAAU,QAAQ,CAAC;GAExC,aAAa;IACX,gBAAgB;IAChB,KAAK,MAAM,WAAW,UAAU,OAAO,CAAC,GAAG,QAAQ;GACrD;EACF,CAAC;EAED,aAAa;GACX,KAAK,MAAM,WAAW,UAAU,OAAO,CAAC,GAAG,QAAQ;EACrD;CACF,CAAC;AACH"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-taskboard",
   "description": "Agent-first task board for the DSH web GUI: host-authoritative task ledger with taskboard_* agent tools, project (= workspace) claim boundaries, per-task model execution in fresh sessions, host-side cron scheduling, and a live SSE kanban view. Mounts via the official dsh plugin system — no DSH source changes.",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "main": "lib/index.js",
   "exports": {

package/src/client/board/AlertModal.tsx

@@ -0,0 +1,36 @@
+/**
+ * A lightweight alert modal — replaces native alert() with a themed overlay
+ * that matches the shell design tokens.
+ *
+ * @module dsh-taskboard/client/board/AlertModal
+ */
+import { useState, useEffect } from 'react'
+
+/** Show a non-blocking alert modal. Returns true when opened. */
+export function useAlert(): { alert: (msg: string) => void; el: React.ReactNode } {
+  const [msg, setMsg] = useState<string | null>(null)
+  const show = (m: string) => setMsg(m)
+  const close = () => setMsg(null)
+  const el = msg !== null
+    ? <AlertModal message={msg} onClose={close} />
+    : null
+  return { alert: show, el }
+}
+
+function AlertModal({ message, onClose }: { message: string; onClose: () => void }) {
+  useEffect(() => {
+    const handler = (e: KeyboardEvent) => { if (e.key === 'Escape') onClose() }
+    window.addEventListener('keydown', handler)
+    return () => window.removeEventListener('keydown', handler)
+  }, [onClose])
+
+  return (
+    <div className="dsh-atb-alert-backdrop" onClick={onClose}>
+      <div className="dsh-atb-alert" onClick={e => e.stopPropagation()}>
+        <div className="dsh-atb-alert-icon">⛔</div>
+        <div className="dsh-atb-alert-msg">{message}</div>
+        <button type="button" className="dsh-atb-btn" data-primary="true" onClick={onClose}>知道了</button>
+      </div>
+    </div>
+  )
+}

package/src/client/board/TaskBoard.tsx

@@ -7,10 +7,11 @@
 import { useSyncExternalStore } from 'react'
 import type { BoardController, ControllerState } from '../controller.ts'
 import type { TaskRecord, TaskStatus, Urgency } from '../../shared/protocol.ts'
-import { MAIN_STATUSES } from '../../shared/protocol.ts'
+import { MAIN_STATUSES, canTransition } from '../../shared/protocol.ts'
 import { DRAG_TYPE, TaskCard } from './TaskCard.tsx'
 import { TaskDetail } from './TaskDetail.tsx'
 import { TaskFormModal } from './TaskFormModal.tsx'
+import { useAlert } from './AlertModal.tsx'
 
 /** Column labels. */
 const COLUMN_LABELS: Readonly<Record<TaskStatus, string>> = {
@@ -23,8 +24,6 @@ const COLUMN_LABELS: Readonly<Record<TaskStatus, string>> = {
   archived: '已归档',
 }
 
-/** The two columns between which cards may be dragged both ways. */
-const DRAGGABLE_STATUSES: ReadonlySet<TaskStatus> = new Set(['backlog', 'todo'])
 
 /** Urgency chip labels. */
 const URGENCY_LABELS: Readonly<Record<Urgency, string>> = {
@@ -59,12 +58,16 @@ export function TaskBoard({ controller }: { controller: BoardController }) {
   )
   const live = filterTasks(state, state.ledger.tasks.filter(t => t.trashedAt === undefined))
   const selected = state.selectedId === undefined ? undefined : state.ledger.tasks.find(t => t.id === state.selectedId)
+  const { alert: showAlert, el: alertEl } = useAlert()
 
   return (
     <div className="dsh-atb-board">
       <div className="dsh-atb-toolbar">
         <h2 className="dsh-atb-title">Agent 任务看板</h2>
         <span className="dsh-atb-count">{live.length} 任务 · rev {state.ledger.revision}</span>
+        <button type="button" className="dsh-atb-btn" data-primary="true" onClick={() => controller.setComposer(true)}>
+          + 新建任务
+        </button>
         <div className="dsh-atb-spacer" />
         <select
           className="dsh-atb-select"
@@ -90,9 +93,6 @@ export function TaskBoard({ controller }: { controller: BoardController }) {
         <button type="button" className="dsh-atb-btn" onClick={() => controller.toggleSecondary()}>
           {state.secondaryOpen ? '返回看板' : '其它任务'}
         </button>
-        <button type="button" className="dsh-atb-btn" data-primary="true" onClick={() => controller.setComposer(true)}>
-          + 新建任务
-        </button>
       </div>
 
       {state.error !== undefined && <div className="dsh-atb-error">{state.error}</div>}
@@ -103,34 +103,31 @@ export function TaskBoard({ controller }: { controller: BoardController }) {
           <div className="dsh-atb-columns">
             {MAIN_STATUSES.map(status => {
               const columnTasks = live.filter(t => t.status === status)
-              const dropTarget = DRAGGABLE_STATUSES.has(status)
               return (
                 <div
                   className="dsh-atb-column"
                   key={status}
-                  onDragOver={dropTarget
-                    ? (e) => {
-                        if (e.dataTransfer.types.includes(DRAG_TYPE)) {
-                          e.preventDefault()
-                          e.dataTransfer.dropEffect = 'move'
-                          e.currentTarget.dataset.dragover = 'true'
-                        }
-                      }
-                    : undefined}
-                  onDragLeave={dropTarget
-                    ? (e) => { delete e.currentTarget.dataset.dragover }
-                    : undefined}
-                  onDrop={dropTarget
-                    ? (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 === undefined || task.status === status) return
-                        void controller.move(id, task.version, status)
-                      }
-                    : undefined}
+                  onDragOver={(e) => {
+                    if (e.dataTransfer.types.includes(DRAG_TYPE)) {
+                      e.preventDefault()
+                      e.dataTransfer.dropEffect = 'move'
+                      e.currentTarget.dataset.dragover = 'true'
+                    }
+                  }}
+                  onDragLeave={(e) => { delete e.currentTarget.dataset.dragover }}
+                  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 === undefined || task.status === status) return
+                    if (!canTransition(task.status, status)) {
+                      showAlert(`无法从「${COLUMN_LABELS[task.status]}」拖至「${COLUMN_LABELS[status]}」`)
+                      return
+                    }
+                    void controller.move(id, task.version, status)
+                  }}
                 >
                   <div className="dsh-atb-colhead">
                     {COLUMN_LABELS[status]}
@@ -142,7 +139,8 @@ export function TaskBoard({ controller }: { controller: BoardController }) {
                         key={task.id}
                         task={task}
                         controller={controller}
-                        draggable={dropTarget}
+                        draggable
+                        onAlert={showAlert}
                       />
                     ))}
                     {columnTasks.length === 0 && <div className="dsh-atb-empty">无任务</div>}
@@ -165,6 +163,8 @@ export function TaskBoard({ controller }: { controller: BoardController }) {
           task={state.editingId === undefined ? undefined : state.ledger.tasks.find(t => t.id === state.editingId)}
         />
       )}
+
+      {alertEl}
     </div>
   )
 }

package/src/client/board/TaskCard.tsx

@@ -20,9 +20,10 @@ export const DRAG_TYPE = 'application/x-dsh-atb-task'
  * 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).
  */
-export function TaskCard({ task, controller, draggable = false }: { task: TaskRecord; controller: BoardController; draggable?: boolean }) {
+export function TaskCard({ task, controller, draggable = false, onAlert }: { task: TaskRecord; controller: BoardController; draggable?: boolean; onAlert?: (msg: string) => void }) {
   const last = task.executions.length > 0 ? task.executions[task.executions.length - 1] : undefined
   return (
     <button
@@ -31,6 +32,15 @@ export function TaskCard({ task, controller, draggable = false }: { task: TaskRe
       data-urgency={task.urgency}
       draggable={draggable}
       onDragStart={(e) => {
+        // Block drag if a session is still executing this task
+        const running = task.executions.find(ex => ex.outcome === 'running')
+        if (running !== undefined) {
+          e.preventDefault()
+          const msg = `该任务正在由【${task.title}】会话执行，不能拖动`
+          if (onAlert !== undefined) onAlert(msg)
+          else alert(msg)
+          return
+        }
         e.dataTransfer.setData(DRAG_TYPE, task.id)
         e.dataTransfer.effectAllowed = 'move'
         e.currentTarget.dataset.dragging = 'true'

package/src/client/board/TaskDetail.tsx

@@ -84,6 +84,16 @@ export function TaskDetail({ task, controller }: { task: TaskRecord; controller:
         </div>
         <div className="dsh-atb-detail-topbtns">
           <button type="button" className="dsh-atb-detail-edit" onClick={() => controller.openEditor(task.id)}>✎ 编辑</button>
+          {canRun && (
+            <button
+              type="button"
+              className="dsh-atb-detail-run"
+              title={task.model !== undefined ? `新会话执行（${task.model.model}）` : '新会话执行（默认模型）'}
+              onClick={() => void controller.run(task.id)}
+            >
+              ▶ 立即执行
+            </button>
+          )}
           <button type="button" className="dsh-atb-detail-close" aria-label="关闭" onClick={() => controller.select(undefined)}>✕</button>
         </div>
       </div>
@@ -103,11 +113,6 @@ export function TaskDetail({ task, controller }: { task: TaskRecord; controller:
       )}
 
       <div className="dsh-atb-detail-actions">
-        {canRun && (
-          <button type="button" className="dsh-atb-runbtn" onClick={() => void controller.run(task.id)}>
-            ▶ 执行 · 新会话{task.model !== undefined ? `（${task.model.model}）` : '（默认模型）'}
-          </button>
-        )}
         <div className="dsh-atb-movebtns">
           {moveTargets(task).map(to => to === 'done'
             ? (confirmDone
@@ -118,10 +123,10 @@ export function TaskDetail({ task, controller }: { task: TaskRecord; controller:
                       <button type="button" className="dsh-atb-btn" onClick={() => setConfirmDone(false)}>取消</button>
                     </span>
                   )
-                : <button key={to} type="button" className="dsh-atb-movebtn" data-to={to} onClick={() => setConfirmDone(true)}>✓ {MOVE_LABEL[to]}</button>)
+                : <button key={to} type="button" className="dsh-atb-movebtn" data-to={to} onClick={() => setConfirmDone(true)}>移至→{MOVE_LABEL[to]}</button>)
             : (
                 <button key={to} type="button" className="dsh-atb-movebtn" data-to={to} onClick={() => void controller.move(task.id, task.version, to)}>
-                  {MOVE_LABEL[to]}
+                  移至→{MOVE_LABEL[to]}
                 </button>
               ))}
           <button type="button" className="dsh-atb-movebtn" data-to="blocked" onClick={() => void controller.toggleBlocked(task)}>

package/src/client/board/TaskFormModal.tsx

@@ -94,6 +94,9 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
   const cronBad = mode === 'scheduled' && (cronMatch === null || nextRun === null)
   const valid = title.trim().length > 0 && workspaceId !== '' && !cronBad
 
+  // A task already in progress cannot be run again (host rejects it).
+  const runBlocked = editing && task.status === 'in_progress'
+
   const submit = (): void => {
     if (!valid) return
     const picked = model !== '' ? (JSON.parse(model) as { provider: string; model: string }) : undefined
@@ -121,6 +124,39 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
     }
   }
 
+  /** Save the form, then immediately trigger a manual run of the task. */
+  const submitAndRun = (): void => {
+    if (!valid || runBlocked) return
+    const picked = model !== '' ? (JSON.parse(model) as { provider: string; model: string }) : undefined
+    if (editing) {
+      void (async () => {
+        const saved = await controller.update(task.id, task.version, {
+          title,
+          description,
+          prompt,
+          urgency,
+          workspaceId,
+          execution: mode === 'scheduled' ? { mode, cron: cron.trim() } : { mode },
+          model: picked ?? null,
+        })
+        if (saved) await controller.run(task.id)
+      })()
+    } else {
+      void (async () => {
+        const id = await controller.create({
+          title,
+          workspaceId,
+          urgency,
+          description: description.length > 0 ? description : undefined,
+          prompt: prompt.length > 0 ? prompt : undefined,
+          execution: mode === 'scheduled' ? { mode, cron: cron.trim() } : { mode },
+          model: picked,
+        })
+        if (id !== undefined) await controller.run(id)
+      })()
+    }
+  }
+
   const hint = !valid
     ? (title.trim().length === 0 ? '请填写标题' : workspaceId === '' ? '请选择项目' : 'Cron 表达式无效（分 时 日 月 周）')
     : mode === 'scheduled' && nextRun !== null
@@ -233,6 +269,15 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
           <span className="dsh-atb-modal-hint" data-tone={valid ? undefined : 'bad'}>{hint}</span>
           <span className="dsh-atb-modal-footbtns">
             <button type="button" className="dsh-atb-btn" onClick={() => controller.closeForm()}>取消</button>
+            <button
+              type="button"
+              className="dsh-atb-btn"
+              disabled={!valid || runBlocked}
+              title={runBlocked ? '任务正在执行中，不能重复发起' : '保存后立即发起执行（新会话）'}
+              onClick={submitAndRun}
+            >
+              ⚡ 立即执行
+            </button>
             <button type="button" className="dsh-atb-btn" data-primary="true" disabled={!valid} onClick={submit}>
               {editing ? '保存修改' : '创建任务'}
             </button>
@@ -247,6 +292,7 @@ export function TaskFormModal({ controller, task }: { controller: BoardControlle
 interface TaskRecordLike {
   id: string
   version: number
+  status?: string
   title: string
   description: string
   prompt: string

package/src/client/controller.ts

@@ -166,25 +166,29 @@ export class BoardController {
   toggleSecondary(): void { this.setState({ secondaryOpen: !this.state.secondaryOpen }) }
 
   // ---------------------------------------------------------------- writes
-  /** Create a task (composer submit). */
-  async create(body: Parameters<TaskboardClient['create']>[0]): Promise<void> {
+  /** Create a task (composer submit); returns the new task id, undefined on failure. */
+  async create(body: Parameters<TaskboardClient['create']>[0]): Promise<string | undefined> {
     try {
-      await this.client.create(body)
+      const summary = await this.client.create(body)
       this.setState({ composerOpen: false, error: undefined })
       await this.refresh()
+      return summary.id
     } catch (error) {
       this.setState({ error: error instanceof Error ? error.message : String(error) })
+      return undefined
     }
   }
 
   /** Edit task fields (form modal submit; the GUI is the owner surface). */
-  async update(id: string, ifVersion: number, body: Omit<UpdateTaskBody, 'ifVersion'>): Promise<void> {
+  async update(id: string, ifVersion: number, body: Omit<UpdateTaskBody, 'ifVersion'>): Promise<boolean> {
     try {
       await this.client.update(id, { ifVersion, ...body })
       this.setState({ composerOpen: false, editingId: undefined, error: undefined })
       await this.refresh()
+      return true
     } catch (error) {
       this.setState({ error: error instanceof Error ? error.message : String(error) })
+      return false
     }
   }
 

package/src/client/styles.ts

@@ -172,12 +172,12 @@ html[data-dsh-atb-active] .dsh-atb-view { display: flex; flex-direction: column;
 .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;
@@ -376,6 +376,29 @@ html[data-dsh-atb-active] .dsh-atb-view { display: flex; flex-direction: column;
 .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

package/src/host/execution.ts

@@ -54,6 +54,8 @@ export interface ExecutionDeps {
   mintSessionId?: () => string
   /** Mint message ids (injectable for tests). */
   mintMessageId?: () => string
+  /** Best-effort session rename (pins the session list title to the task title). */
+  renameSession?: (sessionId: string, title: string) => void
 }
 
 /** Outcome of a run request (immediate; the run settles asynchronously). */
@@ -182,16 +184,25 @@ export class ExecutionService {
     // 3. Attach the session to the workspace (GUI project session list).
     await this.deps.workspaces.attach(task.workspaceId, sessionId).catch(() => { /* cosmetic */ })
 
+    // 3b. Best-effort rename: pin the session title to the task title so the
+    //     session list shows the task name (a user-sourced title also stops
+    //     automatic first-prompt retitling).
+    try {
+      this.deps.renameSession?.(sessionId, task.title)
+    } catch { /* cosmetic */ }
+
     // 4. Record the session id (execution is really started now).
     await this.patchExecution(executionId, { sessionId })
 
     // 5. Submit the effective prompt as an ordinary user message and settle
     //    on quiescence (turn/end errors were already folded by the listener).
+    //    Source `user` (not `plugin`) so the opening message renders as a
+    //    normal user bubble in the conversation, exactly like a typed prompt.
     const message = {
       id: this.deps.mintMessageId?.() ?? MessageId(`msg-taskboard-${crypto.randomUUID()}`),
       role: 'user' as const,
       content: [{ type: 'text' as const, text: this.executionPrompt(task) }],
-      source: { kind: 'plugin' as const, plugin: 'dsh-taskboard' },
+      source: { kind: 'user' as const },
     }
     handle.agent.followup(message)
 
@@ -221,12 +232,11 @@ export class ExecutionService {
 
   /** The prompt text one execution submits (task context + instructions). */
   private executionPrompt(task: TaskRecord): string {
-    const head = `【任务看板执行】${task.title}（任务 ID: ${task.id}）`
     const state = '本任务由执行服务启动本会话并已置为 in_progress（你无需再认领，也无需移到 done）。'
     const tail = `完成后请：1) 用 taskboard_get 读取任务 ${task.id} 拿最新 version；`
       + `2) 用 taskboard_comment_add 留评论（做了什么改动、如何验证、剩余风险）；`
       + `3) 用 taskboard_move 把任务 ${task.id} 移到 in_review（带 ifVersion）。`
-    return `${head}\n\n${state}\n\n${effectivePrompt(task)}\n\n${tail}`
+    return `【任务】${task.title}（任务 ID: ${task.id}）\n\n${state}\n\n${effectivePrompt(task)}\n\n${tail}`
   }
 
   /** Move a task back out of in_progress after a failed start. */

package/src/index.ts

@@ -84,6 +84,16 @@ export function apply(ctx: Context): void {
         },
         events,
         now,
+        renameSession: (sessionId, title) => {
+          // Best-effort: pin the execution session's title to the task title
+          // through the log-backed session-title service (user-sourced rename).
+          try {
+            const sessions = agentCtx.get('sessions') as { get(id: string): unknown } | undefined
+            const sessionTitle = agentCtx.get('sessionTitle') as { rename(session: unknown, title: string): unknown } | undefined
+            const session = sessions?.get(sessionId)
+            if (session !== undefined && sessionTitle !== undefined) sessionTitle.rename(session, title)
+          } catch { /* cosmetic */ }
+        },
         defaultModel: () => {
           try {
             const selection = agentCtx.get('agentDefaultModel') as { currentSelection?: () => { provider: string; model: string } | undefined } | undefined