dsh-taskboard 0.2.2 → 0.3.3

package/lib/host/git.js

@@ -0,0 +1,234 @@
+//#region src/host/git.ts
+/** Timeout for quick read-only queries (rev-parse / status / log / diff). */
+const QUICK_TIMEOUT_MS = 2e3;
+/** Timeout for structural operations (worktree add/remove, merge, branch). */
+const HEAVY_TIMEOUT_MS = 15e3;
+/** Directory under a workspace where task worktrees live. */
+const WORKTREE_DIR = ".dsh-worktrees";
+/**
+* Build the task branch name `task/<标题>+<taskId>` (plan §9 拍板).
+*
+* Title sanitizing: whitespace runs collapse to `-`; git-illegal characters
+* (`~ ^ : ? * [ \ / @ { }` and friends) are stripped; `..` collapses; the
+* segment is trimmed of leading/trailing `.-` and truncated to ~20 code
+* points; an empty result falls back to the bare `task/<taskId>`.
+* @param title - the task title (already normalized 1..200 chars).
+* @param taskId - the task id (stable suffix).
+* @returns the branch name.
+*/
+function sanitizeBranchName(title, taskId) {
+	const segment = title.trim().replace(/\s+/g, "-").replace(/[/\\~^:?*[\]@{}"'<>|#%&;$!`'=,;()]+/g, "").replace(/\.\.+/g, ".").replace(/^[-.\s]+|[-.\s]+$/g, "");
+	const head = Array.from(segment).slice(0, 20).join("").replace(/^[-.]+|[-.]+$/g, "");
+	return head.length === 0 ? `task/${taskId}` : `task/${head}+${taskId}`;
+}
+/** The canonical worktree path of a task inside its workspace (forward slashes). */
+function worktreePathOf(workspacePath, taskId) {
+	return `${workspacePath.replace(/[\\/]+$/, "").replaceAll("\\", "/")}/${WORKTREE_DIR}/${taskId}`;
+}
+/** Real exec layer over child_process.execFile (windowsHide, timeout, maxBuffer). */
+const realExec = (args, options) => new Promise((resolve) => {
+	(async () => {
+		const { execFile } = await import("node:child_process");
+		execFile("git", args, {
+			cwd: options.cwd,
+			timeout: options.timeout ?? QUICK_TIMEOUT_MS,
+			windowsHide: true,
+			maxBuffer: 4 * 1024 * 1024,
+			encoding: "utf8"
+		}, (error, stdout, stderr) => {
+			resolve({
+				ok: error === null,
+				stdout: String(stdout ?? ""),
+				stderr: String(stderr ?? "")
+			});
+		});
+	})().catch(() => resolve({
+		ok: false,
+		stdout: "",
+		stderr: "exec unavailable"
+	}));
+});
+/**
+* Build a {@link GitFace} over an injectable exec layer.
+* @param exec - the exec function (real `git` when omitted).
+*/
+function createGitFace(exec = realExec) {
+	const quick = (args, cwd) => exec(args, {
+		cwd,
+		timeout: QUICK_TIMEOUT_MS
+	});
+	const heavy = (args, cwd) => exec(args, {
+		cwd,
+		timeout: HEAVY_TIMEOUT_MS
+	});
+	const locks = /* @__PURE__ */ new Map();
+	const withRootLock = (root, fn) => {
+		const next = (locks.get(root) ?? Promise.resolve()).then(fn, fn);
+		locks.set(root, next.catch(() => {}));
+		return next;
+	};
+	return {
+		async detect(root) {
+			const r = await quick(["rev-parse", "--is-inside-work-tree"], root);
+			return r.ok && r.stdout.trim() === "true";
+		},
+		async binaryAvailable() {
+			const r = await quick(["--version"]);
+			return r.ok && r.stdout.startsWith("git version");
+		},
+		prepareWorktree: (root, path, branch, mode = "fresh") => withRootLock(root, async () => {
+			if (mode === "reuse") {
+				const wtHead = await quick(["rev-parse", "HEAD"], path);
+				if (wtHead.ok && wtHead.stdout.trim().length > 0) return {
+					path,
+					branch,
+					baseCommit: wtHead.stdout.trim(),
+					reused: true
+				};
+			}
+			const head = await quick(["rev-parse", "HEAD"], root);
+			if (!head.ok) return void 0;
+			const baseCommit = head.stdout.trim();
+			if ((await quick([
+				"show-ref",
+				"--verify",
+				`refs/heads/${branch}`
+			], root)).ok) {
+				await heavy([
+					"worktree",
+					"remove",
+					"--force",
+					path
+				], root);
+				await heavy(["worktree", "prune"], root);
+				if (!(await heavy([
+					"branch",
+					"-f",
+					branch,
+					"HEAD"
+				], root)).ok) return void 0;
+				if (!(await heavy([
+					"worktree",
+					"add",
+					path,
+					branch
+				], root)).ok) return void 0;
+			} else if (!(await heavy([
+				"worktree",
+				"add",
+				"-b",
+				branch,
+				path
+			], root)).ok) return void 0;
+			return {
+				path,
+				branch,
+				baseCommit
+			};
+		}),
+		async collect(worktreePath, baseCommit) {
+			const facts = {
+				commits: [],
+				commitsTotal: 0,
+				dirtyFiles: [],
+				dirtyFilesTotal: 0,
+				changedFiles: 0
+			};
+			const range = `${baseCommit}..HEAD`;
+			const head = await quick(["rev-parse", "HEAD"], worktreePath);
+			if (head.ok) facts.headCommit = head.stdout.trim();
+			const log = await quick([
+				"log",
+				"--pretty=format:%h %s",
+				range
+			], worktreePath);
+			if (log.ok) {
+				const commits = log.stdout.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).map((line) => {
+					const space = line.indexOf(" ");
+					return space === -1 ? {
+						hash: line,
+						subject: ""
+					} : {
+						hash: line.slice(0, space),
+						subject: line.slice(space + 1)
+					};
+				});
+				facts.commitsTotal = commits.length;
+				facts.commits = commits.slice(0, 50);
+			}
+			const status = await quick(["status", "--porcelain"], worktreePath);
+			if (status.ok) {
+				const dirty = status.stdout.split("\n").map((l) => l.trim()).filter((l) => l.length > 0);
+				facts.dirtyFilesTotal = dirty.length;
+				facts.dirtyFiles = dirty.slice(0, 100);
+			}
+			const shortstat = await quick([
+				"diff",
+				"--shortstat",
+				range
+			], worktreePath);
+			if (shortstat.ok && shortstat.stdout.trim().length > 0) facts.diffStat = shortstat.stdout.trim();
+			const names = await quick([
+				"diff",
+				"--name-only",
+				range
+			], worktreePath);
+			if (names.ok) facts.changedFiles = names.stdout.split("\n").filter((l) => l.trim().length > 0).length;
+			return facts;
+		},
+		merge: (root, branch) => withRootLock(root, async () => {
+			const status = await quick(["status", "--porcelain"], root);
+			if (status.ok) {
+				const dirtyLines = status.stdout.split("\n").map((l) => l.trim()).filter((l) => {
+					if (l.length === 0) return false;
+					const path = l.slice(3);
+					return path !== ".dsh-worktrees" && !path.startsWith(`.dsh-worktrees/`);
+				});
+				if (dirtyLines.length > 0) throw new Error(`主工作区有 ${dirtyLines.length} 处未提交修改，请先提交或暂存后再合并`);
+			}
+			const merged = await heavy([
+				"merge",
+				"--no-ff",
+				"--no-edit",
+				branch
+			], root);
+			if (!merged.ok) {
+				await heavy(["merge", "--abort"], root);
+				throw new Error(`合并失败：${merged.stderr.trim().slice(0, 300)}`);
+			}
+		}),
+		async isAncestor(root, branch) {
+			return (await quick([
+				"merge-base",
+				"--is-ancestor",
+				branch,
+				"HEAD"
+			], root)).ok;
+		},
+		removeWorktree: (root, worktreePath) => withRootLock(root, async () => {
+			const status = await quick(["status", "--porcelain"], worktreePath);
+			if (status.ok && status.stdout.trim().length > 0) {
+				const lines = status.stdout.split("\n").map((l) => l.trim()).filter((l) => l.length > 0);
+				throw new Error(`worktree 有 ${lines.length} 处未提交修改，拒绝删除：\n${lines.slice(0, 10).join("\n")}`);
+			}
+			const removed = await heavy([
+				"worktree",
+				"remove",
+				worktreePath
+			], root);
+			if (!removed.ok) throw new Error(`删除 worktree 失败：${(removed.stderr.trim() || removed.stdout.trim()).slice(0, 300)}`);
+		}),
+		deleteBranch: (root, branch) => withRootLock(root, async () => {
+			const deleted = await heavy([
+				"branch",
+				"-D",
+				branch
+			], root);
+			if (!deleted.ok) throw new Error(`删除分支失败：${deleted.stderr.trim().slice(0, 300)}`);
+		})
+	};
+}
+//#endregion
+export { WORKTREE_DIR, createGitFace, sanitizeBranchName, worktreePathOf };
+
+//# sourceMappingURL=git.js.map

package/lib/host/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","names":[],"sources":["../../src/host/git.ts"],"sourcesContent":["/**\n * Host git face (0.3.0): the ONLY place dsh-taskboard shells out to git.\n * 0.3.1: per-repo serialization of structural operations, binary probing,\n * no-op merge detection, worktree REUSE mode, and evidence size caps.\n *\n * Design invariants (plan §3.4/§3.5):\n * - NARROW interface: detect / binaryAvailable / prepareWorktree / collect /\n *   merge / isAncestor / removeWorktree / deleteBranch — nothing else leaks\n *   into the plugin.\n * - FAIL-SOFT: every call has a timeout and resolves to a benign result\n *   (false / undefined / empty facts) on ANY git failure — a missing git,\n *   a locked worktree, or a damaged repo degrades execution to the original\n *   directory and NEVER fails the ledger or the run pipeline. Only the\n *   explicit user actions (merge / remove / deleteBranch) throw, with a\n *   readable message the GUI surfaces as-is.\n * - SERIALIZED structural ops: concurrent isolated executions on the SAME\n *   repository would race on git's index/worktree locks, so every structural\n *   operation (prepareWorktree / merge / removeWorktree / deleteBranch) runs\n *   inside a per-root in-process mutex. Read-only collects stay concurrent.\n * - INJECTABLE runner: the exec layer is a single function so unit tests\n *   script every path without a real git.\n *\n * @module dsh-taskboard/host/git\n */\nimport type { CommitInfo } from '../shared/protocol.ts'\n\n/** Timeout for quick read-only queries (rev-parse / status / log / diff). */\nconst QUICK_TIMEOUT_MS = 2_000\n\n/** Timeout for structural operations (worktree add/remove, merge, branch). */\nconst HEAVY_TIMEOUT_MS = 15_000\n\n/** Directory under a workspace where task worktrees live. */\nexport const WORKTREE_DIR = '.dsh-worktrees'\n\n/** Evidence caps: commits kept per execution record (newest first). */\nexport const MAX_COMMIT_EVIDENCE = 50\n\n/** Evidence caps: uncommitted-change lines kept per execution record. */\nexport const MAX_DIRTY_EVIDENCE = 100\n\n/** Result of one underlying exec: `ok` is exit-0, output never null. */\nexport interface ExecResult { ok: boolean; stdout: string; stderr: string }\n\n/** The injectable exec layer: run `git <args>` under a cwd with a timeout. */\nexport type ExecFn = (args: string[], options: { cwd?: string; timeout?: number }) => Promise<ExecResult>\n\n/** Facts needed to open an isolated execution. */\nexport interface WorktreeInfo {\n  /** Absolute worktree path (the session's cwd). */\n  path: string\n  /** The task branch checked out there. */\n  branch: string\n  /** Baseline for evidence collection: main HEAD (fresh) or worktree HEAD (reuse). */\n  baseCommit: string\n  /** True when an existing live worktree was kept as-is (续跑). */\n  reused?: boolean\n}\n\n/** Settlement facts collected from a worktree (partial on best-effort basis). */\nexport interface SettlementFacts {\n  headCommit?: string\n  commits: CommitInfo[]\n  /** Total commits before capping (equals commits.length when under the cap). */\n  commitsTotal: number\n  dirtyFiles: string[]\n  /** Total uncommitted lines before capping. */\n  dirtyFilesTotal: number\n  diffStat?: string\n  changedFiles: number\n}\n\n/** The narrow git face the rest of the plugin depends on. */\nexport interface GitFace {\n  /** Whether `root` sits inside a usable git work tree (fail-soft → false). */\n  detect(root: string): Promise<boolean>\n  /** Whether a usable git binary answers at all (distinguishes 未装 git vs 非 git 仓库). */\n  binaryAvailable(): Promise<boolean>\n  /**\n   * Ensure a worktree at `path` on `branch`. Default mode `'fresh'` resets to\n   * the main worktree's current HEAD (每次全新); mode `'reuse'` keeps a live\n   * worktree exactly as-is (续跑 — agent's commits and uncommitted changes\n   * survive) and falls back to a fresh creation when none is alive. Resolves\n   * undefined on any failure — callers degrade to the original directory.\n   */\n  prepareWorktree(root: string, path: string, branch: string, mode?: 'fresh' | 'reuse'): Promise<WorktreeInfo | undefined>\n  /** Collect settlement facts (never throws; missing pieces stay unset). */\n  collect(worktreePath: string, baseCommit: string): Promise<SettlementFacts>\n  /** Merge `branch` into the main worktree (`--no-ff`); THROWS with a readable reason. */\n  merge(root: string, branch: string): Promise<void>\n  /** Whether `branch` is already an ancestor of HEAD (a merge would be a no-op). */\n  isAncestor(root: string, branch: string): Promise<boolean>\n  /** Remove a worktree; THROWS when it still has uncommitted changes. */\n  removeWorktree(root: string, worktreePath: string): Promise<void>\n  /** Delete a branch; THROWS (e.g. still checked out in a worktree). */\n  deleteBranch(root: string, branch: string): Promise<void>\n}\n\n/**\n * Build the task branch name `task/<标题>+<taskId>` (plan §9 拍板).\n *\n * Title sanitizing: whitespace runs collapse to `-`; git-illegal characters\n * (`~ ^ : ? * [ \\ / @ { }` and friends) are stripped; `..` collapses; the\n * segment is trimmed of leading/trailing `.-` and truncated to ~20 code\n * points; an empty result falls back to the bare `task/<taskId>`.\n * @param title - the task title (already normalized 1..200 chars).\n * @param taskId - the task id (stable suffix).\n * @returns the branch name.\n */\nexport function sanitizeBranchName(title: string, taskId: string): string {\n  const segment = title.trim()\n    .replace(/\\s+/g, '-')\n    .replace(/[/\\\\~^:?*[\\]@{}\"'<>|#%&;$!`'=,;()]+/g, '')\n    .replace(/\\.\\.+/g, '.')\n    .replace(/^[-.\\s]+|[-.\\s]+$/g, '')\n  const head = Array.from(segment).slice(0, 20).join('').replace(/^[-.]+|[-.]+$/g, '')\n  return head.length === 0 ? `task/${taskId}` : `task/${head}+${taskId}`\n}\n\n/** The canonical worktree path of a task inside its workspace (forward slashes). */\nexport function worktreePathOf(workspacePath: string, taskId: string): string {\n  const root = workspacePath.replace(/[\\\\/]+$/, '').replaceAll('\\\\', '/')\n  return `${root}/${WORKTREE_DIR}/${taskId}`\n}\n\n/** Real exec layer over child_process.execFile (windowsHide, timeout, maxBuffer). */\nconst realExec: ExecFn = (args, options) => new Promise(resolve => {\n  void (async () => {\n    const { execFile } = await import('node:child_process')\n    execFile('git', args, {\n      cwd: options.cwd,\n      timeout: options.timeout ?? QUICK_TIMEOUT_MS,\n      windowsHide: true,\n      maxBuffer: 4 * 1024 * 1024,\n      encoding: 'utf8',\n    }, (error, stdout, stderr) => {\n      resolve({ ok: error === null, stdout: String(stdout ?? ''), stderr: String(stderr ?? '') })\n    })\n  })().catch(() => resolve({ ok: false, stdout: '', stderr: 'exec unavailable' }))\n})\n\n/**\n * Build a {@link GitFace} over an injectable exec layer.\n * @param exec - the exec function (real `git` when omitted).\n */\nexport function createGitFace(exec: ExecFn = realExec): GitFace {\n  const quick = (args: string[], cwd?: string): Promise<ExecResult> => exec(args, { cwd, timeout: QUICK_TIMEOUT_MS })\n  const heavy = (args: string[], cwd?: string): Promise<ExecResult> => exec(args, { cwd, timeout: HEAVY_TIMEOUT_MS })\n\n  // Per-root mutex (0.3.1): structural git ops on the SAME repository run one\n  // at a time — concurrent isolated executions must not race on git's locks.\n  const locks = new Map<string, Promise<unknown>>()\n  const withRootLock = <T>(root: string, fn: () => Promise<T>): Promise<T> => {\n    const prev = locks.get(root) ?? Promise.resolve()\n    const next = prev.then(fn, fn)\n    locks.set(root, next.catch(() => { /* the chain never blocks later ops */ }))\n    return next\n  }\n\n  return {\n    async detect(root) {\n      const r = await quick(['rev-parse', '--is-inside-work-tree'], root)\n      return r.ok && r.stdout.trim() === 'true'\n    },\n\n    async binaryAvailable() {\n      const r = await quick(['--version'])\n      return r.ok && r.stdout.startsWith('git version')\n    },\n\n    prepareWorktree: (root, path, branch, mode = 'fresh') => withRootLock(root, async () => {\n      // 续跑: a live worktree at the path is kept EXACTLY as-is — the agent's\n      // commits and uncommitted changes survive; the baseline becomes the\n      // worktree's own HEAD so evidence covers only the new run.\n      if (mode === 'reuse') {\n        const wtHead = await quick(['rev-parse', 'HEAD'], path)\n        if (wtHead.ok && wtHead.stdout.trim().length > 0) {\n          return { path, branch, baseCommit: wtHead.stdout.trim(), reused: true }\n        }\n        // No live worktree → fall through to a fresh preparation.\n      }\n\n      // Baseline: the main worktree's current HEAD (also validates the repo).\n      const head = await quick(['rev-parse', 'HEAD'], root)\n      if (!head.ok) return undefined\n      const baseCommit = head.stdout.trim()\n\n      const exists = await quick(['show-ref', '--verify', `refs/heads/${branch}`], root)\n      if (exists.ok) {\n        // Reuse the fixed branch name, but guarantee a FRESH baseline: drop\n        // any stale worktree at the path, move the branch to the current\n        // HEAD, then check the branch out again (每次全新，复用仅作选项保留).\n        await heavy(['worktree', 'remove', '--force', path], root)\n        await heavy(['worktree', 'prune'], root)\n        const moved = await heavy(['branch', '-f', branch, 'HEAD'], root)\n        if (!moved.ok) return undefined\n        const added = await heavy(['worktree', 'add', path, branch], root)\n        if (!added.ok) return undefined\n      } else {\n        const added = await heavy(['worktree', 'add', '-b', branch, path], root)\n        if (!added.ok) return undefined\n      }\n      return { path, branch, baseCommit }\n    }),\n\n    async collect(worktreePath, baseCommit) {\n      const facts: SettlementFacts = { commits: [], commitsTotal: 0, dirtyFiles: [], dirtyFilesTotal: 0, changedFiles: 0 }\n      const range = `${baseCommit}..HEAD`\n\n      const head = await quick(['rev-parse', 'HEAD'], worktreePath)\n      if (head.ok) facts.headCommit = head.stdout.trim()\n\n      const log = await quick(['log', '--pretty=format:%h %s', range], worktreePath)\n      if (log.ok) {\n        const commits = log.stdout.split('\\n')\n          .map(line => line.trim())\n          .filter(line => line.length > 0)\n          .map(line => {\n            const space = line.indexOf(' ')\n            return space === -1\n              ? { hash: line, subject: '' }\n              : { hash: line.slice(0, space), subject: line.slice(space + 1) }\n          })\n        // Evidence caps (0.3.1): the ledger is rewritten whole on every\n        // mutation — cap what a huge branch/status dump can add to it.\n        facts.commitsTotal = commits.length\n        facts.commits = commits.slice(0, MAX_COMMIT_EVIDENCE)\n      }\n\n      const status = await quick(['status', '--porcelain'], worktreePath)\n      if (status.ok) {\n        const dirty = status.stdout.split('\\n').map(l => l.trim()).filter(l => l.length > 0)\n        facts.dirtyFilesTotal = dirty.length\n        facts.dirtyFiles = dirty.slice(0, MAX_DIRTY_EVIDENCE)\n      }\n\n      const shortstat = await quick(['diff', '--shortstat', range], worktreePath)\n      if (shortstat.ok && shortstat.stdout.trim().length > 0) facts.diffStat = shortstat.stdout.trim()\n\n      const names = await quick(['diff', '--name-only', range], worktreePath)\n      if (names.ok) facts.changedFiles = names.stdout.split('\\n').filter(l => l.trim().length > 0).length\n\n      return facts\n    },\n\n    merge: (root, branch) => withRootLock(root, async () => {\n      // Main-clean check. The plugin's own worktree directory\n      // (<root>/.dsh-worktrees) shows up as untracked noise and is EXEMPT —\n      // otherwise merging would be impossible without gitignoring it first.\n      const status = await quick(['status', '--porcelain'], root)\n      if (status.ok) {\n        const dirtyLines = status.stdout.split('\\n')\n          .map(l => l.trim())\n          .filter(l => {\n            if (l.length === 0) return false\n            const path = l.slice(3)\n            return path !== WORKTREE_DIR && !path.startsWith(`${WORKTREE_DIR}/`)\n          })\n        if (dirtyLines.length > 0) {\n          throw new Error(`主工作区有 ${dirtyLines.length} 处未提交修改，请先提交或暂存后再合并`)\n        }\n      }\n      const merged = await heavy(['merge', '--no-ff', '--no-edit', branch], root)\n      if (!merged.ok) {\n        // Roll the half-finished merge back so the main worktree stays usable;\n        // report the ORIGINAL failure verbatim (不自动解决冲突).\n        await heavy(['merge', '--abort'], root)\n        throw new Error(`合并失败：${merged.stderr.trim().slice(0, 300)}`)\n      }\n    }),\n\n    async isAncestor(root, branch) {\n      // exit 0 = branch is an ancestor of (or equal to) HEAD → merge no-op.\n      const r = await quick(['merge-base', '--is-ancestor', branch, 'HEAD'], root)\n      return r.ok\n    },\n\n    removeWorktree: (root, worktreePath) => withRootLock(root, async () => {\n      const status = await quick(['status', '--porcelain'], worktreePath)\n      if (status.ok && status.stdout.trim().length > 0) {\n        const lines = status.stdout.split('\\n').map(l => l.trim()).filter(l => l.length > 0)\n        throw new Error(`worktree 有 ${lines.length} 处未提交修改，拒绝删除：\\n${lines.slice(0, 10).join('\\n')}`)\n      }\n      const removed = await heavy(['worktree', 'remove', worktreePath], root)\n      if (!removed.ok) throw new Error(`删除 worktree 失败：${(removed.stderr.trim() || removed.stdout.trim()).slice(0, 300)}`)\n    }),\n\n    deleteBranch: (root, branch) => withRootLock(root, async () => {\n      const deleted = await heavy(['branch', '-D', branch], root)\n      if (!deleted.ok) throw new Error(`删除分支失败：${deleted.stderr.trim().slice(0, 300)}`)\n    }),\n  }\n}\n"],"mappings":"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"}

package/lib/host/routes.js

@@ -1,8 +1,13 @@
-import { asStatus, asUrgency, canTransition, newCommentId, newTaskId, normalizeBody, normalizeExecution, normalizeModel, normalizePrompt, normalizeTitle, summarize, syncClaim } from "../shared/protocol.js";
+import { asIsolation, asStatus, asUrgency, canTransition, newCommentId, newTaskId, normalizeBody, normalizeExecution, normalizeModel, normalizePrompt, normalizeTitle, summarize, syncClaim } from "../shared/protocol.js";
+import { WORKTREE_DIR, worktreePathOf } from "./git.js";
 import { ROUTE_PREFIX, SSE_PATH } from "../shared/api.js";
+import { join } from "node:path";
+import { readdir, rm } from "node:fs/promises";
 //#region src/host/routes.ts
 /** Heartbeat cadence for the SSE stream. */
 const HEARTBEAT_MS = 2e4;
+/** How long a workspace git-detection result stays cached (fail-soft). */
+const GIT_DETECT_TTL_MS = 6e4;
 /** Validate a pinned model: structural check always, provider route when known. */
 function checkModel(raw, modelProviders) {
 	const model = normalizeModel(raw);
@@ -55,6 +60,11 @@ function num(body, key) {
 	if (v === void 0) return void 0;
 	return typeof v === "number" && Number.isFinite(v) ? v : null;
 }
+/** Normalize an agent preset id: trimmed, non-empty; empty string → undefined. */
+function normalizePresetId(raw) {
+	const t = (raw ?? "").trim();
+	return t.length === 0 ? void 0 : t;
+}
 /** Map a thrown domain error to the envelope. */
 function toFail(error) {
 	const message = error instanceof Error ? error.message : String(error);
@@ -89,6 +99,68 @@ function registerTaskboardRoutes(ctx, options) {
 		for (const res of subscribers) res.write(frame);
 	};
 	store.subscribe(broadcast);
+	const gitCache = /* @__PURE__ */ new Map();
+	const gitHinted = /* @__PURE__ */ new Set();
+	/** Whether <root>/.gitignore (missing file counts as missing) ignores our worktree dir. */
+	const gitignoreMissing = async (path) => {
+		try {
+			const { readFile } = await import("node:fs/promises");
+			return !(await readFile(join(path, ".gitignore"), "utf8")).split("\n").some((l) => {
+				const t = l.trim().replace(/\/+$/, "");
+				return t === ".dsh-worktrees" || t === `/.dsh-worktrees`;
+			});
+		} catch {
+			return true;
+		}
+	};
+	const gitAvailable = async (path) => {
+		if (options.git === void 0) return false;
+		const hit = gitCache.get(path);
+		if (hit !== void 0 && options.now() - hit.at < GIT_DETECT_TTL_MS) return hit.value;
+		let value = false;
+		try {
+			value = await options.git.detect(path);
+		} catch {}
+		gitCache.set(path, {
+			value,
+			at: options.now()
+		});
+		if (value && !gitHinted.has(path)) {
+			gitHinted.add(path);
+			if (await gitignoreMissing(path)) console.info(`[dsh-taskboard] 建议在 ${path}/.gitignore 加入一行 ${WORKTREE_DIR}/ 以隐藏任务 worktree 目录（不会自动修改）`);
+		}
+		return value;
+	};
+	/** List orphan worktree dirs: entries under <ws>/.dsh-worktrees owned by no ledger task. */
+	const listOrphanWorktrees = async () => {
+		const orphans = [];
+		const known = new Set(store.snapshot().tasks.map((t) => t.id));
+		for (const ws of workspaces.list()) {
+			let entries = [];
+			try {
+				entries = (await readdir(join(ws.path, WORKTREE_DIR), { withFileTypes: true })).filter((e) => e.isDirectory()).map((e) => e.name);
+			} catch {}
+			for (const taskId of entries) if (!known.has(taskId)) orphans.push({
+				workspaceId: ws.id,
+				workspacePath: ws.path,
+				taskId,
+				path: worktreePathOf(ws.path, taskId)
+			});
+		}
+		return orphans;
+	};
+	/** Git-enabled workspaces whose .gitignore does not cover the worktree dir. */
+	const listGitignoreSuggestions = async () => {
+		const suggestions = [];
+		for (const ws of workspaces.list()) {
+			if (!await gitAvailable(ws.path)) continue;
+			if (await gitignoreMissing(ws.path)) suggestions.push({
+				workspaceId: ws.id,
+				workspacePath: ws.path
+			});
+		}
+		return suggestions;
+	};
 	const handler = async (req, res) => {
 		try {
 			const pathname = new URL(req.url ?? "/", "http://x").pathname;
@@ -102,9 +174,31 @@ function registerTaskboardRoutes(ctx, options) {
 					return;
 				}
 				if (pathname === `/dsh-taskboard/workspaces`) {
+					const list = workspaces.list();
+					const flags = await Promise.all(list.map((ws) => gitAvailable(ws.path)));
 					json(res, {
 						ok: true,
-						value: workspaces.list()
+						value: list.map((ws, i) => ({
+							...ws,
+							sessionCount: 0,
+							gitAvailable: flags[i]
+						}))
+					});
+					return;
+				}
+				if (pathname === `/dsh-taskboard/diagnostics`) {
+					const ledger = store.snapshot();
+					let staleRunning = 0;
+					for (const t of ledger.tasks) for (const e of t.executions) if (e.outcome === "running") staleRunning += 1;
+					json(res, {
+						ok: true,
+						value: {
+							revision: ledger.revision,
+							tasks: ledger.tasks.length,
+							staleRunning,
+							orphanWorktrees: await listOrphanWorktrees(),
+							gitIgnoreSuggestions: await listGitignoreSuggestions()
+						}
 					});
 					return;
 				}
@@ -149,6 +243,9 @@ function registerTaskboardRoutes(ctx, options) {
 					const status = str(body, "status") === null ? "todo" : asStatus(str(body, "status"));
 					const execution = normalizeExecution(body.execution ?? {}, options.now());
 					const model = body.model === void 0 ? void 0 : checkModel(body.model, options.modelProviders);
+					const isolationRaw = str(body, "isolation");
+					const isolation = isolationRaw === null ? void 0 : asIsolation(isolationRaw);
+					const presetId = normalizePresetId(str(body, "presetId"));
 					const now = options.now();
 					const task = {
 						id: newTaskId(),
@@ -161,6 +258,8 @@ function registerTaskboardRoutes(ctx, options) {
 						blocked: false,
 						execution,
 						model,
+						...isolation !== void 0 ? { isolation } : {},
+						...presetId !== void 0 ? { presetId } : {},
 						version: 1,
 						createdAt: now,
 						updatedAt: now,
@@ -183,7 +282,7 @@ function registerTaskboardRoutes(ctx, options) {
 				}
 				return;
 			}
-			const actionMatch = pathname.match(new RegExp(`^${ROUTE_PREFIX}/tasks/([^/]+)/(\\w+)$`));
+			const actionMatch = pathname.match(new RegExp(`^${ROUTE_PREFIX}/tasks/([^/]+)/([\\w-]+)$`));
 			if (actionMatch !== null) {
 				const id = actionMatch[1];
 				const action = actionMatch[2];
@@ -212,6 +311,13 @@ function registerTaskboardRoutes(ctx, options) {
 						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 = checkModel(body.model, options.modelProviders);
+						const isolationRaw = str(body, "isolation");
+						if (isolationRaw !== null) {
+							if (task.executions.length > 0 || task.status === "in_progress") throw new Error("Error: invalid_input: isolation 已锁定（任务已有执行记录），不可修改");
+							next.isolation = asIsolation(isolationRaw);
+						}
+						if (body.presetId === null) delete next.presetId;
+						else if (body.presetId !== void 0) next.presetId = normalizePresetId(str(body, "presetId"));
 						next.version = task.version + 1;
 						next.updatedAt = options.now();
 						next.updatedBy = { kind: "user" };
@@ -306,6 +412,26 @@ function registerTaskboardRoutes(ctx, options) {
 					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)");
+							if (options.git !== void 0) {
+								const ws = workspaces.get(task.workspaceId);
+								if (ws !== void 0) {
+									const path = worktreePathOf(ws.path, id);
+									try {
+										await options.git.removeWorktree(ws.path, path);
+									} catch (error) {
+										const message = error instanceof Error ? error.message : String(error);
+										if (message.includes("未提交修改")) throw new Error(`Error: invalid_input: ${message}；请先处理这些改动（提交、续跑或手动保存）再物理清除任务`);
+										if (/not a working tree|not a working-tree/i.test(message)) await rm(path, {
+											recursive: true,
+											force: true
+										});
+										else throw new Error(`Error: invalid_input: ${message}`);
+									}
+									if (task.branch !== void 0) try {
+										await options.git.deleteBranch(ws.path, task.branch);
+									} catch {}
+								}
+							}
 							await store.mutate("task-deleted", (ledger) => {
 								ledger.tasks = ledger.tasks.filter((t) => t.id !== id);
 								return [];
@@ -338,7 +464,8 @@ function registerTaskboardRoutes(ctx, options) {
 							json(res, fail("invalid_input", "execution service unavailable").res, 501);
 							return;
 						}
-						const result = await options.run(id);
+						const runOptions = body.reuse === true ? { reuseWorktree: true } : void 0;
+						const result = await options.run(id, runOptions);
 						if (result.ok) json(res, {
 							ok: true,
 							value: result
@@ -368,6 +495,92 @@ function registerTaskboardRoutes(ctx, options) {
 						}
 						return;
 					}
+					if (action === "merge") {
+						if (options.git === void 0) {
+							json(res, fail("invalid_input", "git integration unavailable").res, 501);
+							return;
+						}
+						if (task.branch === void 0) throw new Error("Error: invalid_input: 该任务还没有 worktree 分支（未隔离执行过）");
+						if (task.status === "in_progress") throw new Error("Error: invalid_input: 任务执行中，不能合并");
+						if (task.executions.some((e) => e.outcome === "running")) throw new Error("Error: invalid_input: 任务执行中，不能合并");
+						const ws = workspaces.get(task.workspaceId);
+						if (ws === void 0) throw new Error("Error: not_found: unknown workspace");
+						let noop = false;
+						try {
+							noop = await options.git.isAncestor(ws.path, task.branch);
+						} catch {}
+						if (noop) {
+							json(res, {
+								ok: true,
+								value: {
+									merged: false,
+									noop: true,
+									branch: task.branch
+								}
+							});
+							return;
+						}
+						try {
+							await options.git.merge(ws.path, task.branch);
+						} catch (error) {
+							throw new Error(`Error: invalid_input: ${error instanceof Error ? error.message : String(error)}`);
+						}
+						const mergedComment = {
+							id: newCommentId(),
+							body: normalizeBody(`[系统] 分支 ${task.branch} 已合并到主工作区（--no-ff）。`),
+							version: 1,
+							createdAt: options.now()
+						};
+						const next = structuredClone(task);
+						next.comments.push(mergedComment);
+						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: {
+								merged: true,
+								branch: task.branch
+							}
+						});
+						return;
+					}
+					if (action === "worktree-remove") {
+						if (options.git === void 0) {
+							json(res, fail("invalid_input", "git integration unavailable").res, 501);
+							return;
+						}
+						if (task.executions.some((e) => e.outcome === "running")) throw new Error("Error: invalid_input: 任务执行中，不能删除 worktree");
+						const ws = workspaces.get(task.workspaceId);
+						if (ws === void 0) throw new Error("Error: not_found: unknown workspace");
+						const path = worktreePathOf(ws.path, id);
+						try {
+							await options.git.removeWorktree(ws.path, path);
+						} catch (error) {
+							throw new Error(`Error: invalid_input: ${error instanceof Error ? error.message : String(error)}`);
+						}
+						let branchDeleted = false;
+						let branchError;
+						if (body.deleteBranch === true && task.branch !== void 0) try {
+							await options.git.deleteBranch(ws.path, task.branch);
+							branchDeleted = true;
+						} catch (error) {
+							branchError = error instanceof Error ? error.message : String(error);
+						}
+						json(res, {
+							ok: true,
+							value: {
+								removed: true,
+								branchDeleted,
+								...branchError !== void 0 ? { branchError } : {}
+							}
+						});
+						return;
+					}
 					const f = fail("not_found", `unknown action ${action}`);
 					json(res, f.res, f.status);
 				} catch (error) {
@@ -376,6 +589,41 @@ function registerTaskboardRoutes(ctx, options) {
 				}
 				return;
 			}
+			if (pathname === `/dsh-taskboard/worktree-cleanup`) {
+				try {
+					if (options.git === void 0) {
+						json(res, fail("invalid_input", "git integration unavailable").res, 501);
+						return;
+					}
+					const workspaceId = str(body, "workspaceId") ?? "";
+					const taskId = str(body, "taskId") ?? "";
+					const ws = workspaces.get(workspaceId);
+					if (ws === void 0) throw new Error("Error: not_found: unknown workspace");
+					if (store.get(taskId) !== void 0) throw new Error("Error: invalid_input: 任务仍在看板中，请从任务详情页删除其 worktree");
+					const path = worktreePathOf(ws.path, taskId);
+					try {
+						await options.git.removeWorktree(ws.path, path);
+					} catch (error) {
+						const message = error instanceof Error ? error.message : String(error);
+						if (/not a working tree|not a working-tree/i.test(message)) await rm(path, {
+							recursive: true,
+							force: true
+						});
+						else throw new Error(`Error: invalid_input: ${message}`);
+					}
+					json(res, {
+						ok: true,
+						value: {
+							cleaned: true,
+							path
+						}
+					});
+				} catch (error) {
+					const f = toFail(error);
+					json(res, f.res, f.status);
+				}
+				return;
+			}
 			res.writeHead(404);
 			res.end();
 		} catch (error) {