dsh-taskboard 0.1.0

package/lib/host/execution.js

@@ -0,0 +1,189 @@
+import { effectivePrompt, newExecutionId } from "../shared/protocol.js";
+import { MessageId } from "./sdk.js";
+//#region src/host/execution.ts
+/**
+* Host execution service: runs a task through dsh's REAL session machinery —
+* a fresh agent+session inside the task's project workspace (creation carries
+* the pinned model when the task has one), the session is attached to the
+* workspace so it appears in the GUI's project session list, the effective
+* prompt is submitted as an ordinary user message, and the turn settlement
+* (turn/end reason) is folded back into the task's execution record.
+*
+* Every execution is a NEW session: clean context, no reuse of previous runs.
+*
+* @module dsh-taskboard/host/execution
+*/
+/** Whether a turn/end payload closed with an error reason. */
+function isErrorTurnEnd(data) {
+	if (typeof data !== "object" || data === null) return void 0;
+	const reason = data.reason;
+	if (typeof reason !== "object" || reason === null) return void 0;
+	if (reason.kind !== "error") return void 0;
+	const error = reason.error;
+	const detail = JSON.stringify(error) ?? "";
+	const message = typeof error?.message === "string" ? error.message : "turn failed";
+	console.error("[dsh-taskboard] turn error detail:", detail.slice(0, 2e3));
+	return { message };
+}
+/**
+* The execution service.
+*/
+var ExecutionService = class {
+	deps;
+	/** Execution ids currently settling. */
+	settling = /* @__PURE__ */ new Map();
+	/** @param deps - store + agents + workspaces + events + clock. */
+	constructor(deps) {
+		this.deps = deps;
+		deps.events.onSessionEvent((sessionId, event) => {
+			if (event.type !== "turn/end") return;
+			const failure = isErrorTurnEnd(event.data);
+			if (failure !== void 0) this.noteFailure(sessionId, failure.message);
+		});
+	}
+	/** Record a turn failure against the running execution of that session. */
+	noteFailure(sessionId, message) {
+		this.deps.store.mutate("execution-recorded", (ledger) => {
+			for (const task of ledger.tasks) for (const execution of task.executions) if (execution.sessionId === sessionId && execution.outcome === "running") {
+				execution.outcome = "failed";
+				execution.error = message.slice(0, 500);
+				execution.endedAt = this.deps.now();
+				return [task];
+			}
+		});
+	}
+	/** Patch one task's execution record in the ledger. */
+	async patchExecution(executionId, patch) {
+		await this.deps.store.mutate("execution-recorded", (ledger) => {
+			for (const task of ledger.tasks) {
+				const execution = task.executions.find((e) => e.id === executionId);
+				if (execution !== void 0) {
+					Object.assign(execution, patch);
+					return [task];
+				}
+			}
+		});
+	}
+	/**
+	* Run one task now (manual button or scheduler tick).
+	* @param taskId - the task to run.
+	* @param trigger - what started it.
+	* @returns the immediate result; settlement lands in the ledger.
+	*/
+	async run(taskId, trigger) {
+		const task = this.deps.store.get(taskId);
+		if (task === void 0 || task.trashedAt !== void 0) return {
+			ok: false,
+			error: `no task ${taskId}`
+		};
+		if (task.status === "in_progress") return {
+			ok: false,
+			error: "task is already in progress"
+		};
+		const workspace = this.deps.workspaces.get(task.workspaceId);
+		if (workspace === void 0) return {
+			ok: false,
+			error: `unknown workspace ${task.workspaceId}`
+		};
+		const executionId = newExecutionId();
+		const sessionId = this.deps.mintSessionId?.() ?? `session-taskboard-${crypto.randomUUID()}`;
+		await this.deps.store.mutate("execution-recorded", (ledger) => {
+			const target = ledger.tasks.find((t) => t.id === taskId);
+			if (target === void 0) return void 0;
+			target.executions.push({
+				id: executionId,
+				trigger,
+				startedAt: this.deps.now(),
+				outcome: "running"
+			});
+			target.status = "in_progress";
+			target.updatedAt = this.deps.now();
+			target.updatedBy = { kind: "user" };
+			return [target];
+		});
+		let handle;
+		try {
+			const model = task.model ?? this.deps.defaultModel?.();
+			handle = await this.deps.agents.create({
+				sessionId,
+				meta: { cwd: workspace.path },
+				...model !== void 0 ? { agentOptions: {
+					provider: model.provider,
+					model: model.model
+				} } : {}
+			});
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			await this.patchExecution(executionId, {
+				outcome: "failed",
+				error: message.slice(0, 500),
+				endedAt: this.deps.now()
+			});
+			await this.revertProgress(taskId);
+			return {
+				ok: false,
+				error: message
+			};
+		}
+		await this.deps.workspaces.attach(task.workspaceId, sessionId).catch(() => {});
+		await this.patchExecution(executionId, { sessionId });
+		const message = {
+			id: this.deps.mintMessageId?.() ?? MessageId(`msg-taskboard-${crypto.randomUUID()}`),
+			role: "user",
+			content: [{
+				type: "text",
+				text: this.executionPrompt(task)
+			}],
+			source: {
+				kind: "plugin",
+				plugin: "dsh-taskboard"
+			}
+		};
+		handle.agent.followup(message);
+		const settle = () => {
+			this.settling.delete(executionId);
+			this.deps.store.mutate("execution-recorded", (ledger) => {
+				for (const t of ledger.tasks) {
+					const execution = t.executions.find((e) => e.id === executionId);
+					if (execution !== void 0 && execution.outcome === "running") {
+						execution.outcome = "succeeded";
+						execution.endedAt = this.deps.now();
+						return [t];
+					}
+				}
+			});
+		};
+		this.settling.set(executionId, settle);
+		handle.agent.whenIdle().then(settle, () => {
+			this.noteFailure(sessionId, "agent did not reach quiescence");
+			settle();
+		});
+		return {
+			ok: true,
+			executionId,
+			sessionId
+		};
+	}
+	/** 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}`;
+	}
+	/** Move a task back out of in_progress after a failed start. */
+	async revertProgress(taskId) {
+		await this.deps.store.mutate("execution-recorded", (ledger) => {
+			const target = ledger.tasks.find((t) => t.id === taskId);
+			if (target !== void 0 && target.status === "in_progress") {
+				target.status = "todo";
+				target.updatedAt = this.deps.now();
+				return [target];
+			}
+		});
+	}
+};
+//#endregion
+export { ExecutionService };
+
+//# sourceMappingURL=execution.js.map

package/lib/host/execution.js.map

@@ -0,0 +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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"}

package/lib/host/protocol-text.js

@@ -0,0 +1,37 @@
+//#region src/host/protocol-text.ts
+/**
+* The agent workflow protocol text — the single source the system-prompt
+* section serves. This is a behavioral contract, not a feature ad: claiming
+* discipline, optimistic-version retry rules, review handoff, and the
+* user-only completion gate.
+*
+* The regression test (tests/protocol.spec.ts) locks the discipline
+* sentences, so editing the text without revisiting the test fails loud.
+*
+* @module dsh-taskboard/host/protocol-text
+*/
+/** The protocol section served to every agent (Chinese UI deployment). */
+const TASKBOARD_PROTOCOL = [
+	"本机已安装 dsh-taskboard 插件（DSH 任务看板）：任务挂在项目（DSH workspace）上，",
+	"用 taskboard_* 工具读写；人在 Web GUI 看板上实时看到同样数据。能力：查板(list/get)、",
+	"建卡(create)、改卡(update)、移卡(move)、评论(comment_add/comments)、删除(delete=仅标记)。",
+	"任务带紧急度(urgent红/normal紫/relaxed蓝)、执行方式(claim认领/scheduled定时)与可选指定模型。",
+	"工作纪律：",
+	"1. 开工先查板：开始工作前先 taskboard_list（按本项目过滤、status=todo），有可认领任务时按纪律认领。",
+	"2. 先读后动：动卡前先 taskboard_get 并读评论；评论视为最新需求，若要求等待/暂缓，停下汇报，不改状态。",
+	"3. 先认领再干活：把 todo→in_progress（带 ifVersion）成功后，才开始读代码/分析实现；",
+	"   认领失败（版本冲突/项目边界不符/已被他人持有）就停止并报告，绝不循环重试或接管他人任务。",
+	"4. 版本冲突只重试一次：ifVersion 冲突时重新读卡，仅当状态仍可认领且需求未变时用新版本号重试一次，再失败即停止报告。",
+	"5. 验收交接：实现并自验后，评论记录（改动/验证结果/剩余风险），再把 in_progress→in_review。",
+	"6. 完成须用户确认：你永远不能把任务移到 done——那是用户的确认动作；blocked=无法继续，canceled=不再继续。",
+	"7. backlog=未授权：backlog 任务不算批准执行，被指派也不是授权，除非用户明确要求。",
+	"8. 模型与定时只读：任务的 model 与 execution 配置归创建者/用户所有，update 工具不允许你修改这两个字段。",
+	"项目边界：只有属于任务所在项目的会话才能认领（todo→in_progress）或执行它。",
+	"用户提到「任务看板/看板/认领任务」时即指本插件，请据此协作。"
+].join("\n");
+/** Registered section name. */
+const PROTOCOL_SECTION_NAME = "plugin:dsh-taskboard";
+//#endregion
+export { PROTOCOL_SECTION_NAME, TASKBOARD_PROTOCOL };
+
+//# sourceMappingURL=protocol-text.js.map

package/lib/host/protocol-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-text.js","names":[],"sources":["../../src/host/protocol-text.ts"],"sourcesContent":["/**\n * The agent workflow protocol text — the single source the system-prompt\n * section serves. This is a behavioral contract, not a feature ad: claiming\n * discipline, optimistic-version retry rules, review handoff, and the\n * user-only completion gate.\n *\n * The regression test (tests/protocol.spec.ts) locks the discipline\n * sentences, so editing the text without revisiting the test fails loud.\n *\n * @module dsh-taskboard/host/protocol-text\n */\n\n/** The protocol section served to every agent (Chinese UI deployment). */\nexport const TASKBOARD_PROTOCOL = [\n  '本机已安装 dsh-taskboard 插件（DSH 任务看板）：任务挂在项目（DSH workspace）上，',\n  '用 taskboard_* 工具读写；人在 Web GUI 看板上实时看到同样数据。能力：查板(list/get)、',\n  '建卡(create)、改卡(update)、移卡(move)、评论(comment_add/comments)、删除(delete=仅标记)。',\n  '任务带紧急度(urgent红/normal紫/relaxed蓝)、执行方式(claim认领/scheduled定时)与可选指定模型。',\n  '工作纪律：',\n  '1. 开工先查板：开始工作前先 taskboard_list（按本项目过滤、status=todo），有可认领任务时按纪律认领。',\n  '2. 先读后动：动卡前先 taskboard_get 并读评论；评论视为最新需求，若要求等待/暂缓，停下汇报，不改状态。',\n  '3. 先认领再干活：把 todo→in_progress（带 ifVersion）成功后，才开始读代码/分析实现；',\n  '   认领失败（版本冲突/项目边界不符/已被他人持有）就停止并报告，绝不循环重试或接管他人任务。',\n  '4. 版本冲突只重试一次：ifVersion 冲突时重新读卡，仅当状态仍可认领且需求未变时用新版本号重试一次，再失败即停止报告。',\n  '5. 验收交接：实现并自验后，评论记录（改动/验证结果/剩余风险），再把 in_progress→in_review。',\n  '6. 完成须用户确认：你永远不能把任务移到 done——那是用户的确认动作；blocked=无法继续，canceled=不再继续。',\n  '7. backlog=未授权：backlog 任务不算批准执行，被指派也不是授权，除非用户明确要求。',\n  '8. 模型与定时只读：任务的 model 与 execution 配置归创建者/用户所有，update 工具不允许你修改这两个字段。',\n  '项目边界：只有属于任务所在项目的会话才能认领（todo→in_progress）或执行它。',\n  '用户提到「任务看板/看板/认领任务」时即指本插件，请据此协作。',\n].join('\\n')\n\n/** Section order inside the tool-guidance band (100–199). */\nexport const PROTOCOL_SECTION_ORDER = 180\n\n/** Registered section name. */\nexport const PROTOCOL_SECTION_NAME = 'plugin:dsh-taskboard'\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAa,qBAAqB;CAChC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC,CAAC,KAAK,IAAI;;AAMX,MAAa,wBAAwB"}

package/lib/host/routes.js

@@ -0,0 +1,369 @@
+import { asStatus, asUrgency, canTransition, newCommentId, newTaskId, normalizeBody, normalizeExecution, normalizePrompt, normalizeTitle, summarize } from "../shared/protocol.js";
+import { ROUTE_PREFIX, SSE_PATH } from "../shared/api.js";
+//#region src/host/routes.ts
+/** Heartbeat cadence for the SSE stream. */
+const HEARTBEAT_MS = 2e4;
+/** JSON-envelope writer. */
+function json(res, payload, status = 200) {
+	const body = JSON.stringify(payload);
+	res.writeHead(status, {
+		"content-type": "application/json; charset=utf-8",
+		"cache-control": "no-store"
+	});
+	res.end(body);
+}
+/** Domain failure → envelope + HTTP status. */
+function fail(code, message) {
+	return {
+		res: {
+			ok: false,
+			error: {
+				code,
+				message
+			}
+		},
+		status: code === "invalid_input" ? 400 : code === "not_found" ? 404 : code === "version_conflict" ? 409 : code === "forbidden" ? 403 : 500
+	};
+}
+/** Read one JSON body (null on parse failure). */
+async function readBody(req) {
+	const chunks = [];
+	for await (const chunk of req) chunks.push(chunk);
+	if (chunks.length === 0) return {};
+	try {
+		const parsed = JSON.parse(Buffer.concat(chunks).toString("utf8"));
+		return typeof parsed === "object" && parsed !== null ? parsed : null;
+	} catch {
+		return null;
+	}
+}
+/** String field accessor (null when absent/not a string). */
+function str(body, key) {
+	const v = body[key];
+	return typeof v === "string" ? v : null;
+}
+/** Number field accessor (undefined when absent; null when present but not a number). */
+function num(body, key) {
+	const v = body[key];
+	if (v === void 0) return void 0;
+	return typeof v === "number" && Number.isFinite(v) ? v : null;
+}
+/** Map a thrown domain error to the envelope. */
+function toFail(error) {
+	const message = error instanceof Error ? error.message : String(error);
+	const code = message.startsWith("Error: ") ? message.slice(7).split(":")[0] : void 0;
+	if (code !== void 0 && [
+		"invalid_input",
+		"not_found",
+		"version_conflict",
+		"invalid_transition",
+		"forbidden",
+		"internal"
+	].includes(code)) return fail(code, message.slice(7 + code.length + 2));
+	if (code === "workspace_mismatch") return fail("forbidden", message.slice(7 + code.length + 2));
+	return fail("invalid_input", message);
+}
+/**
+* Register the taskboard routes.
+* @param ctx - context carrying the webServer service.
+* @param options - store + workspaces + clock.
+* @returns the disposer.
+*/
+function registerTaskboardRoutes(ctx, options) {
+	const { store, workspaces } = options;
+	const subscribers = /* @__PURE__ */ new Set();
+	let heartbeat;
+	const broadcast = (change) => {
+		const frame = `event: change\ndata: ${JSON.stringify({
+			revision: change.revision,
+			kind: change.kind,
+			tasks: change.tasks.map(summarize)
+		})}\n\n`;
+		for (const res of subscribers) res.write(frame);
+	};
+	store.subscribe(broadcast);
+	const handler = async (req, res) => {
+		try {
+			const pathname = new URL(req.url ?? "/", "http://x").pathname;
+			if (req.method === "GET") {
+				if (pathname === `/dsh-taskboard/state`) {
+					await store.load();
+					json(res, {
+						ok: true,
+						value: store.snapshot()
+					});
+					return;
+				}
+				if (pathname === `/dsh-taskboard/workspaces`) {
+					json(res, {
+						ok: true,
+						value: workspaces.list()
+					});
+					return;
+				}
+				const taskMatch = pathname.match(new RegExp(`^${ROUTE_PREFIX}/tasks/([^/]+)$`));
+				if (taskMatch !== null) {
+					const task = store.get(taskMatch[1]);
+					if (task === void 0) {
+						const f = fail("not_found", "no such task");
+						json(res, f.res, f.status);
+						return;
+					}
+					json(res, {
+						ok: true,
+						value: task
+					});
+					return;
+				}
+				res.writeHead(404);
+				res.end();
+				return;
+			}
+			if (req.method !== "POST") {
+				res.writeHead(405);
+				res.end();
+				return;
+			}
+			if (!(req.headers["content-type"] ?? "").toLowerCase().startsWith("application/json")) {
+				json(res, fail("invalid_input", "content-type must be application/json").res, 415);
+				return;
+			}
+			const body = await readBody(req);
+			if (body === null) {
+				json(res, fail("invalid_input", "body is not a JSON object").res, 400);
+				return;
+			}
+			if (pathname === `/dsh-taskboard/tasks`) {
+				try {
+					const title = normalizeTitle(str(body, "title") ?? "");
+					const workspaceId = str(body, "workspaceId") ?? "";
+					if (workspaces.get(workspaceId) === void 0) throw new Error("Error: not_found: unknown workspace");
+					const urgency = asUrgency(str(body, "urgency") ?? "");
+					const status = str(body, "status") === null ? "todo" : asStatus(str(body, "status"));
+					const execution = normalizeExecution(body.execution ?? {}, options.now());
+					const model = body.model;
+					const now = options.now();
+					const task = {
+						id: newTaskId(),
+						title,
+						description: (str(body, "description") ?? "").trim(),
+						prompt: normalizePrompt(str(body, "prompt") ?? void 0),
+						workspaceId,
+						urgency,
+						status,
+						blocked: false,
+						execution,
+						model,
+						version: 1,
+						createdAt: now,
+						updatedAt: now,
+						createdBy: { kind: "user" },
+						updatedBy: { kind: "user" },
+						comments: [],
+						executions: []
+					};
+					await store.mutate("task-created", (ledger) => {
+						ledger.tasks.push(task);
+						return [task];
+					});
+					json(res, {
+						ok: true,
+						value: summarize(task)
+					}, 201);
+				} catch (error) {
+					const f = toFail(error);
+					json(res, f.res, f.status);
+				}
+				return;
+			}
+			const actionMatch = pathname.match(new RegExp(`^${ROUTE_PREFIX}/tasks/([^/]+)/(\\w+)$`));
+			if (actionMatch !== null) {
+				const id = actionMatch[1];
+				const action = actionMatch[2];
+				try {
+					const task = store.get(id);
+					if (task === void 0) throw new Error("Error: not_found: no such task");
+					if (action === "update") {
+						const ifVersion = num(body, "ifVersion");
+						if (ifVersion === void 0 || ifVersion === null) throw new Error("Error: version_conflict: ifVersion required");
+						if (ifVersion !== task.version) throw new Error(`Error: version_conflict: stale version ${ifVersion} (current ${task.version})`);
+						const next = structuredClone(task);
+						const title = str(body, "title");
+						if (title !== null) next.title = normalizeTitle(title);
+						const description = str(body, "description");
+						if (description !== null) next.description = description.trim();
+						const prompt = str(body, "prompt");
+						if (prompt !== null) next.prompt = normalizePrompt(prompt);
+						const urgency = str(body, "urgency");
+						if (urgency !== null) next.urgency = asUrgency(urgency);
+						const workspaceId = str(body, "workspaceId");
+						if (workspaceId !== null) {
+							if (workspaces.get(workspaceId) === void 0) throw new Error("Error: not_found: unknown workspace");
+							next.workspaceId = workspaceId;
+						}
+						if (typeof body.blocked === "boolean") next.blocked = body.blocked;
+						if (body.execution !== void 0) next.execution = normalizeExecution(body.execution, options.now());
+						if (body.model === null) next.model = void 0;
+						else if (body.model !== void 0) next.model = body.model;
+						next.version = task.version + 1;
+						next.updatedAt = options.now();
+						next.updatedBy = { kind: "user" };
+						await store.mutate("task-updated", (ledger) => {
+							const i = ledger.tasks.findIndex((t) => t.id === id);
+							ledger.tasks[i] = next;
+							return [next];
+						});
+						json(res, {
+							ok: true,
+							value: summarize(next)
+						});
+						return;
+					}
+					if (action === "move") {
+						const ifVersion = num(body, "ifVersion");
+						const status = str(body, "status") ?? "";
+						if (ifVersion === void 0 || ifVersion === null) throw new Error("Error: version_conflict: ifVersion required");
+						if (ifVersion !== task.version) throw new Error(`Error: version_conflict: stale version ${ifVersion} (current ${task.version})`);
+						const to = asStatus(status);
+						if (!canTransition(task.status, to)) throw new Error(`Error: invalid_transition: illegal transition ${task.status} → ${to}`);
+						const next = structuredClone(task);
+						next.status = to;
+						next.version = task.version + 1;
+						next.updatedAt = options.now();
+						next.updatedBy = { kind: "user" };
+						if (task.status === "todo" && to === "in_progress") next.blocked = false;
+						await store.mutate("task-moved", (ledger) => {
+							const i = ledger.tasks.findIndex((t) => t.id === id);
+							ledger.tasks[i] = next;
+							return [next];
+						});
+						json(res, {
+							ok: true,
+							value: summarize(next)
+						});
+						return;
+					}
+					if (action === "comment") {
+						const bodyText = str(body, "body") ?? "";
+						const comment = {
+							id: newCommentId(),
+							body: normalizeBody(bodyText),
+							version: 1,
+							createdAt: options.now()
+						};
+						const next = structuredClone(task);
+						next.comments.push(comment);
+						next.version = task.version + 1;
+						next.updatedAt = options.now();
+						await store.mutate("comment-added", (ledger) => {
+							const i = ledger.tasks.findIndex((t) => t.id === id);
+							ledger.tasks[i] = next;
+							return [next];
+						});
+						json(res, {
+							ok: true,
+							value: comment
+						}, 201);
+						return;
+					}
+					if (action === "delete") {
+						if (body.purge === true) {
+							if (task.trashedAt === void 0) throw new Error("Error: invalid_input: purge requires a trashed task (soft-delete first)");
+							await store.mutate("task-deleted", (ledger) => {
+								ledger.tasks = ledger.tasks.filter((t) => t.id !== id);
+								return [];
+							});
+							json(res, {
+								ok: true,
+								value: { purged: true }
+							});
+							return;
+						}
+						const ifVersion = num(body, "ifVersion");
+						if (ifVersion === void 0 || ifVersion === null) throw new Error("Error: version_conflict: ifVersion required");
+						if (ifVersion !== task.version) throw new Error(`Error: version_conflict: stale version ${ifVersion} (current ${task.version})`);
+						const next = structuredClone(task);
+						next.trashedAt = options.now();
+						next.version = task.version + 1;
+						await store.mutate("task-deleted", (ledger) => {
+							const i = ledger.tasks.findIndex((t) => t.id === id);
+							ledger.tasks[i] = next;
+							return [next];
+						});
+						json(res, {
+							ok: true,
+							value: { trashed: true }
+						});
+						return;
+					}
+					if (action === "run") {
+						if (options.run === void 0) {
+							json(res, fail("invalid_input", "execution service unavailable").res, 501);
+							return;
+						}
+						const result = await options.run(id);
+						if (result.ok) json(res, {
+							ok: true,
+							value: result
+						}, 202);
+						else {
+							const f = fail("invalid_input", result.error);
+							json(res, f.res, f.status);
+						}
+						return;
+					}
+					const f = fail("not_found", `unknown action ${action}`);
+					json(res, f.res, f.status);
+				} catch (error) {
+					const f = toFail(error);
+					json(res, f.res, f.status);
+				}
+				return;
+			}
+			res.writeHead(404);
+			res.end();
+		} catch (error) {
+			const f = fail("internal", error instanceof Error ? error.message : String(error));
+			json(res, f.res, f.status);
+		}
+	};
+	const sse = (req, res) => {
+		res.writeHead(200, {
+			"content-type": "text/event-stream; charset=utf-8",
+			"cache-control": "no-cache",
+			connection: "keep-alive"
+		});
+		res.write("retry: 2000\n\n");
+		res.write(`event: hello\ndata: ${JSON.stringify({ revision: store.snapshot().revision })}\n\n`);
+		subscribers.add(res);
+		if (heartbeat === void 0) heartbeat = setInterval(() => {
+			for (const current of subscribers) current.write(": ping\n\n");
+		}, HEARTBEAT_MS);
+		req.on("close", () => {
+			subscribers.delete(res);
+			if (subscribers.size === 0 && heartbeat !== void 0) {
+				clearInterval(heartbeat);
+				heartbeat = void 0;
+			}
+		});
+	};
+	const disposers = [ctx.webServer.register({
+		kind: "prefix",
+		path: ROUTE_PREFIX,
+		handler
+	}), ctx.webServer.register({
+		kind: "exact",
+		path: SSE_PATH,
+		handler: sse
+	})];
+	return () => {
+		for (const dispose of disposers) dispose();
+		if (heartbeat !== void 0) clearInterval(heartbeat);
+		for (const res of subscribers) res.end();
+		subscribers.clear();
+	};
+}
+//#endregion
+export { registerTaskboardRoutes };
+
+//# sourceMappingURL=routes.js.map