@sideboard-ai/core 0.1.242 → 0.1.244

package/dist/{chunk-R3YKDTVE.js → chunk-YJJ2A5CI.js}

@@ -2,13 +2,13 @@ import {
   extractPresentedPlan,
   readPlanFile,
   writePlanFile
-} from "./chunk-DJU54RYW.js";
+} from "./chunk-PGPSIEMW.js";
 import {
-  PLAN_MODE_INSTRUCTION,
   adjustBrightsyTurnExit,
   allAdapters,
   applyAgentEvent,
   clipAgentEventForPaint,
+  compactSummaryPart,
   finalizeParts,
   getAdapter,
   isBrightsyNdjsonLine,
@@ -21,10 +21,11 @@ import {
   parseBrightsyCliLine,
   parseSessionQuotaResetAt,
   partsToAssistantText,
+  planModeTurnInstruction,
   resolveQuotaFallbackAgent,
   stripBrightsyNdjsonNoise,
   toolDescription
-} from "./chunk-QXYWLO6W.js";
+} from "./chunk-CYYQ6577.js";
 import {
   SLACK_REPLY_FORMATTING,
   addWorkspace,
@@ -47,7 +48,7 @@ import {
   stageAbsolutePathsAsAttachments,
   stageBuffersAsAttachments,
   syncWorkspacesFromThreads
-} from "./chunk-BILEJG3V.js";
+} from "./chunk-GFRC6JQN.js";
 import {
   addPrStackLayer,
   allocateTeamName,
@@ -96,7 +97,7 @@ import {
   worktreeDisplayLabelForGroup,
   worktreeNameFromPath,
   worktreeSlugForTicket
-} from "./chunk-O3UAQAYA.js";
+} from "./chunk-E6C5NR46.js";
 import {
   ATTACHMENTS_DIR,
   DETACHED_JOBS_DIR,
@@ -159,7 +160,7 @@ import {
   sumUsageList,
   updateAdvancedSettings,
   usageOnLimit
-} from "./chunk-P3DCZRER.js";
+} from "./chunk-PPJ5JTWA.js";
 import {
   examplePrefixedBranch,
   sanitizeGitBranchPrefix
@@ -181,7 +182,7 @@ import {
   updateThread,
   withThreadLock,
   writeThread
-} from "./chunk-3AJUH66R.js";
+} from "./chunk-6I5YQTNK.js";
 import {
   annotateDevAccessRuns,
   appDataDir,
@@ -441,9 +442,9 @@ async function spawnAgentTurn(thread, input, onEvent) {
       `Cannot spawn ${thread.agent}: thread ${thread.id} has no worktreePath`
     );
   }
-  const { isGlobalThread: isGlobalThread2 } = await import("./global-workspace-ZJBBICFJ.js");
+  const { isGlobalThread: isGlobalThread2 } = await import("./global-workspace-2N6KISDO.js");
   if (isGlobalThread2(thread)) {
-    const { ensureGlobalCoordinatorCwd: ensureGlobalCoordinatorCwd2 } = await import("./coordinator-prompt-5UINTEA6.js");
+    const { ensureGlobalCoordinatorCwd: ensureGlobalCoordinatorCwd2 } = await import("./coordinator-prompt-WQIICPT6.js");
     ensureGlobalCoordinatorCwd2(
       isOrchestratorThread(thread) ? { orchestratorThreadId: thread.id } : void 0
     );
@@ -634,9 +635,9 @@ function gitActionExpansion(action, base) {
     case "commit-push":
       return "Commit any uncommitted work with a purpose-stating message, then push to origin (`git push -u origin HEAD`; this updates an existing PR when one is linked). Do not start a checks loop unless a goal was given.";
     case "create-draft":
-      return "Commit, push, then create a draft PR with `gh pr create --draft -R <origin-owner/name>` (title/body from the change purpose). Update the existing PR instead if one is linked.";
+      return "Commit, push, then create a draft PR with `gh pr create --draft --assignee @me -R <origin-owner/name>` (title/body from the change purpose). Update the existing PR instead if one is linked. Use a different `--assignee` only if the user named someone else.";
     case "create-web":
-      return "Commit, push, then `gh pr create --web -R <origin-owner/name>`.";
+      return "Commit, push, then `gh pr create --web --assignee @me -R <origin-owner/name>`. Use a different `--assignee` only if the user named someone else.";
     case "resolve-conflicts":
       return `Fetch the PR base${base ? ` (\`${base}\`)` : ""}, merge it into this branch, resolve conflicts carefully, then commit and push until the PR is mergeable.`;
     case "ready-for-review":
@@ -744,15 +745,15 @@ function shouldAutoArchiveOnPrMerge(opts) {
 // src/hook/conductor.ts
 import {
   copyFileSync,
-  existsSync as existsSync3,
-  mkdirSync as mkdirSync4,
-  readdirSync,
-  readFileSync as readFileSync3,
+  existsSync as existsSync4,
+  mkdirSync as mkdirSync5,
+  readdirSync as readdirSync2,
+  readFileSync as readFileSync4,
   realpathSync
 } from "fs";
 import { execFileSync } from "child_process";
 import { createServer } from "net";
-import { basename, dirname as dirname3, join as join5, resolve, sep } from "path";
+import { basename, dirname as dirname4, join as join6, resolve, sep } from "path";
 import { execa as execa2 } from "execa";
 import { createInterface as createInterface2 } from "readline";
 
@@ -1150,12 +1151,38 @@ ${match.text}`, "");
   blocks.push("Continue from this context. Do not repeat the summary unless asked.");
   return blocks.join("\n");
 }
+function compactArchiveProse(message) {
+  if (message.origin === "continue") return null;
+  if (message.role === "summary") return null;
+  let text = (message.text ?? "").trim();
+  if (!text && message.role === "agent") {
+    text = lastAssistantMessageText(message.parts).trim();
+  }
+  if (!text || isInternalAgentStatusText(text)) return null;
+  return { role: message.role, text, ts: message.ts };
+}
+function messagesForCompactArchive(older) {
+  const out = [];
+  for (const message of older) {
+    const prose = compactArchiveProse(message);
+    if (prose) out.push(prose);
+  }
+  return out;
+}
+function appendCompactedMessages(existing, older) {
+  const next = messagesForCompactArchive(older);
+  if (!existing?.length) return next;
+  if (!next.length) return existing;
+  return [...existing, ...next];
+}
 function applyCompaction(messages, summaryText, thresholds = {}) {
   const { older, recent } = splitForCompaction(messages, thresholds);
   if (older.length === 0) return messages;
+  const text = summaryText.trim();
   const summary = {
     role: "summary",
-    text: summaryText.trim(),
+    text,
+    parts: [compactSummaryPart(text)],
     ts: (/* @__PURE__ */ new Date()).toISOString()
   };
   return [summary, ...recent];
@@ -1183,6 +1210,7 @@ async function maybeCompactContext(thread, thresholds = {}, summarize = summariz
     cwd: thread.worktreePath
   });
   let messages = applyCompaction(thread.messages, summary, thresholds);
+  const compactedMessages = appendCompactedMessages(thread.compactedMessages, older);
   const resetSession = shouldResetSessionForOccupancy({ messages: thread.messages });
   if (resetSession) {
     messages = applyForwardOccupancy(messages);
@@ -1190,6 +1218,7 @@ async function maybeCompactContext(thread, thresholds = {}, summarize = summariz
   const next = {
     ...thread,
     messages,
+    ...compactedMessages.length ? { compactedMessages } : { compactedMessages: void 0 },
     sessionId: resetSession ? null : thread.sessionId,
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
@@ -1725,1664 +1754,1669 @@ function saveWorktreeRunPorts(worktreePath, scriptName, ports) {
 `, "utf8");
 }
 
-// src/hook/conductor.ts
-var PORT_RANGE_SIZE = 10;
-var RECLAIM_RETRY_DELAY_MS = 40;
-var RECLAIM_TRIES = 8;
-function matchSimpleGlob(pattern, name) {
-  const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".");
-  return new RegExp(`^${escaped}$`).test(name);
-}
-function readWorktreeInclude(repoPath) {
-  const path = join5(repoPath, ".worktreeinclude");
-  if (!existsSync3(path)) return [];
-  return readFileSync3(path, "utf8").split("\n").map((l) => l.trim()).filter((l) => l && !l.startsWith("#"));
-}
-function resolveFilesToCopy(repoPath) {
-  const fromInclude = readWorktreeInclude(repoPath);
-  if (fromInclude.length) return fromInclude;
-  const settings = loadRepoSettings(repoPath);
-  if (settings?.filesToCopy?.length) return settings.filesToCopy;
-  if (settings?.fileIncludeGlobs?.length) {
-    const matched = [];
-    try {
-      for (const entry of readdirSync(repoPath, { withFileTypes: true })) {
-        if (!entry.isFile()) continue;
-        for (const glob of settings.fileIncludeGlobs) {
-          if (matchSimpleGlob(glob, entry.name) || matchSimpleGlob(basename(glob), entry.name)) {
-            matched.push(entry.name);
-            break;
-          }
-        }
-      }
-    } catch {
-    }
-    if (matched.length) return [...new Set(matched)];
-  }
-  const defaults = [];
-  try {
-    for (const entry of readdirSync(repoPath, { withFileTypes: true })) {
-      if (entry.isFile() && entry.name.startsWith(".env")) {
-        defaults.push(entry.name);
-      }
-    }
-  } catch {
-  }
-  if (defaults.length) return defaults;
-  return [".env.local", ".env"];
-}
-function copyConfiguredFiles(repoPath, worktreePath) {
-  const patterns = resolveFilesToCopy(repoPath);
-  const copied = [];
-  for (const rel of patterns) {
-    const src = join5(repoPath, rel);
-    if (!existsSync3(src)) continue;
-    const dest = join5(worktreePath, rel);
-    mkdirSync4(dirname3(dest), { recursive: true });
-    copyFileSync(src, dest);
-    copied.push(rel);
-  }
-  return copied;
-}
-var cachedLoginEnv = null;
-async function captureLoginEnv() {
-  if (cachedLoginEnv) return { ...cachedLoginEnv };
-  const shell = process.env.SHELL?.trim() || (process.platform === "darwin" ? "/bin/zsh" : "/bin/bash");
-  try {
-    const result = await execa2(shell, ["-l", "-c", "env -0"], {
-      reject: false,
-      timeout: 5e3
-    });
-    if (result.exitCode === 0 && result.stdout) {
-      const env = { ...process.env };
-      for (const entry of result.stdout.split("\0")) {
-        if (!entry) continue;
-        const eq = entry.indexOf("=");
-        if (eq <= 0) continue;
-        const key = entry.slice(0, eq);
-        const value = entry.slice(eq + 1);
-        if (key) env[key] = value;
-      }
-      cachedLoginEnv = env;
-      return { ...env };
-    }
-  } catch {
-  }
-  cachedLoginEnv = { ...process.env };
-  return { ...cachedLoginEnv };
+// src/mcp/wait-for-job.ts
+import {
+  appendFileSync as appendFileSync2,
+  existsSync as existsSync3,
+  mkdirSync as mkdirSync4,
+  readdirSync,
+  readFileSync as readFileSync3,
+  writeFileSync as writeFileSync3
+} from "fs";
+import { dirname as dirname3, join as join5 } from "path";
+
+// src/mcp/wait-for-turn.ts
+var MCP_WAIT_FOR_TURN_MAX_MS = 45e3;
+function mcpWaitForTurnTimeoutMs(requested) {
+  const n = requested ?? MCP_WAIT_FOR_TURN_MAX_MS;
+  if (!Number.isFinite(n)) return MCP_WAIT_FOR_TURN_MAX_MS;
+  return Math.min(Math.max(1e3, Math.floor(n)), MCP_WAIT_FOR_TURN_MAX_MS);
 }
-function buildWorkspaceScriptEnv(opts, baseEnv) {
-  const env = stripNestedElectronEnv({
-    ...baseEnv ?? process.env
-  });
-  const name = opts.workspaceName ?? basename(opts.worktreePath);
-  const ports = opts.ports ?? [];
-  const primary = ports[0];
-  env.SIDEBOARD_WORKSPACE_NAME = name;
-  env.SIDEBOARD_WORKSPACE_PATH = opts.worktreePath;
-  env.SIDEBOARD_ROOT_PATH = opts.repoPath;
-  env.SIDEBOARD_IS_LOCAL = "1";
-  if (opts.defaultBranch) env.SIDEBOARD_DEFAULT_BRANCH = opts.defaultBranch;
-  env.CONDUCTOR_WORKSPACE_NAME = name;
-  env.CONDUCTOR_WORKSPACE_PATH = opts.worktreePath;
-  env.CONDUCTOR_ROOT_PATH = opts.repoPath;
-  env.CONDUCTOR_IS_LOCAL = "1";
-  if (opts.defaultBranch) env.CONDUCTOR_DEFAULT_BRANCH = opts.defaultBranch;
-  if (primary != null) {
-    env.SIDEBOARD_PORT = String(primary);
-    env.CONDUCTOR_PORT = String(primary);
-    env.PORT = String(primary);
-    for (let i = 1; i < ports.length; i++) {
-      const p = ports[i];
-      env[`SIDEBOARD_PORT_${i}`] = String(p);
-      env[`CONDUCTOR_PORT_${i}`] = String(p);
-    }
+var MCP_WAIT_STILL_RUNNING_HINT = "Child is still working. Call wait_for_turn again. Do not send_to_thread a check-in (that steers / interrupts) or assume a hang while progress is updating.";
+var MCP_WAIT_QUEUED_HINT = "Child is queued waiting for a concurrency slot \u2014 it has not started yet. Call wait_for_turn again. Do not send_to_thread a check-in (that steers / interrupts), force_stop, or assume it failed to start.";
+var MCP_WAIT_STOPPED_HINT = "Child was stopped before the turn finished. Do not treat this as success. send_to_thread to resume, or tell the user.";
+var MCP_WAIT_BROKEN_HINT = "Child worktree is broken (missing on disk). Tell the user \u2014 do not treat this as success.";
+var MCP_WAIT_ERROR_HINT = "Child turn failed. lastError/text is the failure \u2014 switch agent, tell the user, or retry. Do not treat empty text as success.";
+var MCP_WAIT_INPUT_REQUIRED_HINT = "Child asked the user a question (ask_user). taskState is input-required. Wait for the user to answer in that chat \u2014 do not send_to_thread a check-in.";
+function mcpWaitTaskHint(taskState, status) {
+  switch (taskState) {
+    case "submitted":
+      return MCP_WAIT_QUEUED_HINT;
+    case "working":
+      return MCP_WAIT_STILL_RUNNING_HINT;
+    case "input-required":
+      return MCP_WAIT_INPUT_REQUIRED_HINT;
+    case "canceled":
+      return MCP_WAIT_STOPPED_HINT;
+    case "failed":
+      return status === "broken" ? MCP_WAIT_BROKEN_HINT : MCP_WAIT_ERROR_HINT;
+    default:
+      return void 0;
   }
-  applyWorktreePkgCacheEnv(env, opts.worktreePath);
-  return env;
 }
-function pipeLines(stream, onLine) {
-  if (!stream || !onLine) return;
-  const rl = createInterface2({ input: stream });
-  rl.on("line", onLine);
+
+// src/mcp/wait-for-job.ts
+var MAX_JOB_CONTINUES = 8;
+var MAX_JOB_DELTA_LINES = 80;
+var MAX_JOB_DELTA_CHARS = 4e3;
+var DEFERRED_DONE_MAX_CHARS = 480;
+var GH_WATCH_REFRESH = "Refreshing run status every 3 seconds.";
+var MCP_WAIT_JOB_STILL_RUNNING_HINT = "Job is still running. The type=log pane already appended this delta. Call wait_for_job again. If it is hanging, producing no useful output, or doing the wrong thing, call stop_job (same id) instead of looping forever. Do not end the turn or tell the user you will let them know later.";
+var MCP_STOP_JOB_HINT = "Stopped. The type=log pane is status=failed with the last delta. Do not wait again unless you start a new command.";
+var JOB_ID_RE = /^[a-zA-Z0-9._-]{1,64}$/;
+function mcpWaitForJobTimeoutMs(requested) {
+  return mcpWaitForTurnTimeoutMs(requested);
 }
-function killableListenerPids(raw, selfPid = process.pid) {
-  const pids = [];
-  for (const token of raw.trim().split(/\s+/)) {
-    const pid = Number(token);
-    if (!Number.isFinite(pid) || pid <= 0 || pid === selfPid) continue;
-    pids.push(pid);
+function sanitizeDetachedJobId(id) {
+  const s = id.trim();
+  if (!JOB_ID_RE.test(s)) {
+    throw new Error(`detached-job id must be 1\u201364 chars [A-Za-z0-9._-], got ${JSON.stringify(id)}`);
   }
-  return pids;
+  return s;
 }
-function listUnixListenerPids(port, selfPid) {
+function jobAlive(pid) {
+  if (!Number.isInteger(pid) || pid <= 0) return false;
   try {
-    const raw = execFileSync("lsof", [`-tiTCP:${port}`, "-sTCP:LISTEN"], {
-      encoding: "utf8",
-      stdio: ["ignore", "pipe", "ignore"],
-      timeout: 2e3
-    });
-    return killableListenerPids(raw, selfPid);
+    process.kill(pid, 0);
+    return true;
   } catch {
-    return [];
+    return false;
   }
 }
-function listenerCwd(pid) {
-  if (!Number.isFinite(pid) || pid <= 0) return null;
+function processGroupAlive(pgid) {
+  if (process.platform === "win32") return false;
+  if (!Number.isInteger(pgid) || pgid <= 1) return false;
   try {
-    const raw = execFileSync("lsof", ["-a", "-p", String(pid), "-d", "cwd", "-Fn"], {
-      encoding: "utf8",
-      stdio: ["ignore", "pipe", "ignore"],
-      timeout: 2e3
-    });
-    for (const line of raw.split("\n")) {
-      if (line.startsWith("n") && line.length > 1) return line.slice(1);
-    }
-  } catch {
+    process.kill(-pgid, 0);
+    return true;
+  } catch (err) {
+    return err && typeof err === "object" && "code" in err && err.code === "EPERM";
   }
-  return null;
 }
-function realpathOrResolve(path) {
-  try {
-    return realpathSync(path);
-  } catch {
-    return resolve(path);
-  }
+function jobTreeAlive(pid) {
+  if (pid == null) return false;
+  return jobAlive(pid) || processGroupAlive(pid);
 }
-function isOtherWorktreeListenerCwd(cwd, worktreePath) {
-  const wt = realpathOrResolve(worktreePath);
-  const c = realpathOrResolve(cwd);
-  if (c === wt || c.startsWith(wt + sep)) return false;
-  const parent = dirname3(wt);
-  const thisName = basename(wt);
-  if (!thisName || c === parent) return false;
-  if (!c.startsWith(parent + sep)) return false;
-  const first = c.slice(parent.length + 1).split(sep)[0];
-  return Boolean(first) && first !== thisName;
+function readIntFile(file) {
+  if (!existsSync3(file)) return null;
+  const n = Number.parseInt(readFileSync3(file, "utf8").trim(), 10);
+  return Number.isInteger(n) ? n : null;
 }
-function signalPid(pid, signal) {
-  try {
-    process.kill(pid, signal);
-  } catch {
-  }
+function jobDir(root, id, legacy = false) {
+  return join5(root, legacy ? LEGACY_DETACHED_JOBS_DIR : DETACHED_JOBS_DIR, id);
 }
-function isThisWorktreeListenerCwd(cwd, worktreePath) {
-  const wt = realpathOrResolve(worktreePath);
-  const c = realpathOrResolve(cwd);
-  return c === wt || c.startsWith(wt + sep);
+function resolveJobDir(root, id) {
+  const modern = jobDir(root, id, false);
+  if (existsSync3(modern)) return modern;
+  const legacy = jobDir(root, id, true);
+  if (existsSync3(legacy)) return legacy;
+  return modern;
 }
-function killDetachedRunTree(pid, worktreePath) {
-  if (!Number.isFinite(pid) || pid <= 1 || pid === process.pid) return;
-  const cwd = listenerCwd(pid);
-  if (!cwd || !isThisWorktreeListenerCwd(cwd, worktreePath)) return;
-  try {
-    process.kill(-pid, "SIGTERM");
-  } catch {
-    signalPid(pid, "SIGTERM");
-  }
+function listJobIdsIn(root, rel) {
+  const dir = join5(root, rel);
+  if (!existsSync3(dir)) return [];
+  return readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory() && JOB_ID_RE.test(e.name)).map((e) => e.name);
 }
-function killListenersOnPorts(ports) {
-  const selfPid = process.pid;
-  for (const port of ports) {
-    if (!Number.isFinite(port) || port <= 0) continue;
-    try {
-      if (process.platform === "win32") {
-        execFileSync(
-          "powershell",
-          [
-            "-NoProfile",
-            "-Command",
-            `Get-NetTCPConnection -LocalPort ${port} -ErrorAction SilentlyContinue | Where-Object { $_.OwningProcess -ne ${selfPid} } | ForEach-Object { Stop-Process -Id $_.OwningProcess -Force -ErrorAction SilentlyContinue }`
-          ],
-          { stdio: "ignore", timeout: 3e3 }
-        );
-        continue;
-      }
-      for (const pid of listUnixListenerPids(port, selfPid)) {
-        signalPid(pid, "SIGTERM");
-      }
-    } catch {
-    }
+function listRunningDetachedJobs(worktreePath) {
+  const root = worktreePath.trim();
+  if (!root) return [];
+  const ids = /* @__PURE__ */ new Set([
+    ...listJobIdsIn(root, DETACHED_JOBS_DIR),
+    ...listJobIdsIn(root, LEGACY_DETACHED_JOBS_DIR)
+  ]);
+  const running = [];
+  for (const id of ids) {
+    const dir = resolveJobDir(root, id);
+    const pid = readIntFile(join5(dir, "pid"));
+    if (jobTreeAlive(pid)) running.push(id);
   }
+  return running.sort();
 }
-function killStaleWorktreeListeners(ports, worktreePath, signal = "SIGTERM") {
-  if (!worktreePath.trim()) {
-    killListenersOnPorts(ports);
-    return;
-  }
-  if (process.platform === "win32") {
-    killListenersOnPorts(ports);
-    return;
-  }
-  const selfPid = process.pid;
-  for (const port of ports) {
-    if (!Number.isFinite(port) || port <= 0) continue;
-    for (const pid of listUnixListenerPids(port, selfPid)) {
-      const cwd = listenerCwd(pid);
-      if (cwd && isOtherWorktreeListenerCwd(cwd, worktreePath)) continue;
-      signalPid(pid, signal);
-    }
-  }
+function looksLikeDeferredDonePromise(text) {
+  const t = (text ?? "").trim();
+  if (!t || t.length > DEFERRED_DONE_MAX_CHARS) return false;
+  const unquoted = t.replace(/`[^`]*`/g, " ").replace(/["“”][^"“”]*["“”]/g, " ").replace(/\s+/g, " ").trim();
+  if (!unquoted) return false;
+  return /\b(i['’]?ll|i will)\s+let you know\b/i.test(unquoted) || /\blet you know when\b/i.test(unquoted) || /\b(check back|ping me)\s+when\b/i.test(unquoted) || /\bi(?:['’]ll| will)\s+(report|update you)\s+when\b/i.test(unquoted);
 }
-function killScriptTree(child, ports = []) {
-  const pid = child.pid;
-  if (pid) {
-    try {
-      if (process.platform === "win32") {
-        void execa2("taskkill", ["/pid", String(pid), "/T", "/F"], { reject: false });
-      } else {
-        process.kill(-pid, "SIGTERM");
-        setTimeout(() => {
-          try {
-            process.kill(-pid, "SIGKILL");
-          } catch {
-          }
-        }, 2500).unref?.();
-      }
-    } catch {
-      try {
-        child.kill("SIGTERM");
-      } catch {
-      }
-    }
-  }
-  killListenersOnPorts(ports);
+function isJobContinuePrompt(text) {
+  if (typeof text !== "string") return false;
+  const t = text.trim();
+  return t.startsWith("Detached job still running:") || t.startsWith("You ended the turn after promising to report later");
 }
-async function spawnWorkspaceScript(command, opts) {
-  const loginEnv = await captureLoginEnv();
-  const env = buildWorkspaceScriptEnv(
-    {
-      worktreePath: opts.worktreePath,
-      repoPath: opts.repoPath,
-      workspaceName: opts.workspaceName,
-      defaultBranch: opts.defaultBranch,
-      ports: opts.ports
-    },
-    loginEnv
-  );
-  try {
-    mergeAgentGitAuthEnv(
-      env,
-      await resolveAgentGitAuthEnv(env, { cwd: opts.worktreePath })
-    );
-  } catch {
-  }
-  if (opts.heldPorts?.length) {
-    await Promise.all(opts.heldPorts.map((h) => h.release()));
-  }
-  const shell = process.platform === "darwin" ? "zsh" : "bash";
-  const child = execa2(shell, ["-lc", command], {
-    cwd: opts.worktreePath,
-    reject: false,
-    env,
-    // Own process group so Stop can tear down the whole tree (not just the shell).
-    // There is no settings.toml `stop=` / teardown hook for run scripts.
-    ...process.platform === "win32" ? {} : { detached: true }
-  });
-  pipeLines(child.stdout, opts.onLine);
-  pipeLines(child.stderr, opts.onLine);
-  const ports = opts.ports ?? [];
-  return {
-    pid: child.pid,
-    kill: () => killScriptTree(child, ports),
-    done: child.then((r) => r.exitCode ?? null),
-    child
-  };
+function collapseGhRunWatchLog(text) {
+  if (!text.includes(GH_WATCH_REFRESH)) return text;
+  const frames = text.split(/(?=Refreshing run status every 3 seconds\.)/);
+  const watchFrames = frames.filter((f) => f.includes(GH_WATCH_REFRESH));
+  if (watchFrames.length <= 1) return text;
+  const prefix = frames[0]?.includes(GH_WATCH_REFRESH) ? "" : frames[0] ?? "";
+  const last = watchFrames[watchFrames.length - 1] ?? "";
+  const omitted = watchFrames.length - 1;
+  const note = `(${omitted} identical gh run watch refresh${omitted === 1 ? "" : "es"} omitted)
+`;
+  return [prefix.trimEnd(), note, last.trimStart()].filter(Boolean).join("\n");
 }
-async function attachAbort(handle, signal) {
-  if (signal) {
-    const onAbort = () => handle.kill();
-    if (signal.aborted) onAbort();
-    else signal.addEventListener("abort", onAbort, { once: true });
+function capJobLogDelta(text) {
+  const collapsed = collapseGhRunWatchLog(text);
+  const lines = collapsed.split("\n");
+  let out = lines.length > MAX_JOB_DELTA_LINES ? `\u2026(${lines.length - MAX_JOB_DELTA_LINES} earlier lines omitted)
+${lines.slice(-MAX_JOB_DELTA_LINES).join("\n")}` : collapsed;
+  if (out.length > MAX_JOB_DELTA_CHARS) {
+    out = `\u2026(truncated ${out.length} chars)
+${out.slice(-MAX_JOB_DELTA_CHARS)}`;
   }
-  return handle.done;
+  return out;
 }
-async function runSetupScript(repoPath, worktreePath, onLine, opts) {
-  const settings = loadWorkspaceSettings(worktreePath, repoPath);
-  if (!settings?.setup) return { ran: false, exitCode: null, source: null };
-  const source = workspaceSettingsSourceLabel(worktreePath, repoPath);
-  onLine?.(`[setup] ${source ?? "settings.toml"}`);
-  const handle = await spawnWorkspaceScript(settings.setup, {
-    worktreePath,
-    repoPath,
-    defaultBranch: opts?.defaultBranch,
-    onLine
-  });
-  const exitCode = await attachAbort(handle, opts?.signal);
-  return {
-    ran: true,
-    exitCode,
-    source,
-    kill: handle.kill
-  };
+function formatJobStillRunningContinuePrompt(jobIds) {
+  const ids = jobIds.join(", ");
+  return [
+    `Detached job still running: ${ids}.`,
+    "Do not end this turn. Loop wait_for_job (same id) until stillRunning is false. The log pane updates from each wait result.",
+    "If the job is hanging or doing the wrong thing, call stop_job (same id) instead of looping forever.",
+    "Then report the result. Do not tell the user you will let them know later."
+  ].join(" ");
 }
-async function runConventionSetup(repoPath, worktreePath, onLine, opts) {
-  const found = findConventionSetup(worktreePath, repoPath);
-  if (!found) return { ran: false, exitCode: null, source: null };
-  onLine?.(`[setup] ${found.source}`);
-  const handle = await spawnWorkspaceScript(found.command, {
-    worktreePath,
-    repoPath,
-    defaultBranch: opts?.defaultBranch,
-    onLine
+function formatDeferredDoneContinuePrompt() {
+  return [
+    "You ended the turn after promising to report later, but no detached job is running.",
+    "If tests/pack/deploy still need to run: start once with detached-job.cjs, then loop wait_for_job until stillRunning is false (the log pane updates from wait JSON).",
+    "Do not say you will let the user know later."
+  ].join(" ");
+}
+function turnWatchedDetachedJob(parts) {
+  return parts.some((p) => {
+    if (p.type !== "tool") return false;
+    if (/wait_for_job$/i.test(p.name ?? "") || /stop_job$/i.test(p.name ?? "")) return true;
+    const blob = [p.name, p.detail, p.description, p.input ? JSON.stringify(p.input) : ""].filter(Boolean).join(" ");
+    return /detached-job\.(?:js|cjs)\b/i.test(blob);
   });
-  const exitCode = await attachAbort(handle, opts?.signal);
-  return {
-    ran: true,
-    exitCode,
-    source: found.source,
-    kill: handle.kill
-  };
 }
-async function runWorkspaceSetup(repoPath, worktreePath, onLine, opts) {
-  await ensureWorktreeSideboardIgnored(worktreePath);
-  const review = ensureReviewGuidelinesFile(worktreePath, repoPath);
-  if (review.wrote) {
-    onLine?.(`[setup] wrote ${review.path} \u2014 local Review guidelines`);
-  }
-  let setup = await runSetupScript(repoPath, worktreePath, onLine, opts);
-  if (!setup.ran) {
-    setup = await runCursorWorktreeSetup(repoPath, worktreePath, onLine);
+function planJobContinue(opts) {
+  if (opts.isOrchestrator) return { action: "none" };
+  if (opts.agent === "brightsy") return { action: "none" };
+  if (opts.queueLength > 0) return { action: "none" };
+  if (opts.continueCount >= MAX_JOB_CONTINUES) return { action: "none" };
+  const farewell = looksLikeDeferredDonePromise(opts.chatText);
+  if (opts.runningJobIds.length > 0 && (farewell || opts.watchedJob)) {
+    return {
+      action: "wait",
+      jobIds: opts.runningJobIds,
+      prompt: formatJobStillRunningContinuePrompt(opts.runningJobIds)
+    };
   }
-  if (!setup.ran) {
-    setup = await runConventionSetup(repoPath, worktreePath, onLine, opts);
+  if (looksLikeDeferredDonePromise(opts.chatText) && !opts.alreadyNudged) {
+    return { action: "nudge", prompt: formatDeferredDoneContinuePrompt() };
   }
-  return setup;
+  return { action: "none" };
 }
-async function runArchiveScript(repoPath, worktreePath, onLine) {
-  const settings = loadWorkspaceSettings(worktreePath, repoPath);
-  if (!settings?.archive) return { ran: false, exitCode: null };
-  const handle = await spawnWorkspaceScript(settings.archive, {
-    worktreePath,
-    repoPath,
-    onLine
-  });
-  const exitCode = await handle.done;
-  return { ran: true, exitCode };
+function tailProgress(logFile, maxLines = 12) {
+  if (!existsSync3(logFile)) return "(no log yet)";
+  const lines = readFileSync3(logFile, "utf8").split("\n");
+  return lines.slice(-maxLines).join("\n");
 }
-function listRunScripts(worktreePath, repoPath) {
-  const settings = loadWorkspaceSettings(worktreePath, repoPath);
-  if (!settings?.runScripts.length) return [];
-  return settings.runScripts.filter((s) => {
-    if (!s.availableIn?.length) return true;
-    return s.availableIn.includes("local");
-  });
+function lastProgressLine(progress) {
+  const last = progress.split("\n").map((l) => l.trim()).filter((l) => l && l !== "(no log yet)").at(-1);
+  return last ? last.slice(0, 72) : void 0;
 }
-function getDefaultRunScript(worktreePath, repoPath) {
-  const scripts = listRunScripts(worktreePath, repoPath);
-  if (!scripts.length) return null;
-  return scripts.find((s) => s.default === true) ?? scripts.find((s) => s.name === "dev") ?? scripts.find((s) => s.name !== "all") ?? scripts[0] ?? null;
+function readLogLines(file) {
+  if (!existsSync3(file)) return [];
+  const lines = readFileSync3(file, "utf8").split("\n");
+  if (lines.length && lines[lines.length - 1] === "") lines.pop();
+  return lines;
 }
-function getRunScript(worktreePath, repoPath, name) {
-  const scripts = listRunScripts(worktreePath, repoPath);
-  if (!scripts.length) return null;
-  if (name) {
-    return scripts.find((s) => s.name === name) ?? null;
-  }
-  return getDefaultRunScript(worktreePath, repoPath);
+function takeDelta(logFile, cursorFile) {
+  const lines = readLogLines(logFile);
+  const cursor = readIntFile(cursorFile) ?? 0;
+  const start = Math.min(Math.max(0, cursor), lines.length);
+  return { delta: capJobLogDelta(lines.slice(start).join("\n")), nextCursor: lines.length };
 }
-function getRunMode(worktreePath, repoPath) {
-  return loadWorkspaceSettings(worktreePath, repoPath)?.runMode ?? "concurrent";
+function snapshotJob(dir) {
+  const pid = readIntFile(join5(dir, "pid"));
+  const running = jobTreeAlive(pid);
+  return {
+    pid,
+    running,
+    exitCode: readIntFile(join5(dir, "exit")),
+    log: join5(dir, "log"),
+    cursor: join5(dir, "present.cursor"),
+    progress: tailProgress(join5(dir, "log"))
+  };
 }
-async function reservePort() {
-  return new Promise((resolve2, reject) => {
-    const server = createServer();
-    let released = false;
-    const release = () => new Promise((res) => {
-      if (released) {
-        res();
-        return;
-      }
-      released = true;
-      server.close(() => res());
-    });
-    server.listen(0, "127.0.0.1", () => {
-      const addr = server.address();
-      if (!addr || typeof addr === "string") {
-        void release().then(() => reject(new Error("Failed to allocate port")));
-        return;
-      }
-      resolve2({ port: addr.port, release });
-    });
-    server.on("error", reject);
-  });
+function toResult(id, snap, extra) {
+  const failed = extra?.failed === true || !snap.running && snap.exitCode != null && snap.exitCode !== 0;
+  const ok = !snap.running && snap.exitCode === 0;
+  const stillRunning = snap.running && !ok;
+  const { delta, nextCursor } = takeDelta(snap.log, snap.cursor);
+  try {
+    mkdirSync4(dirname3(snap.cursor), { recursive: true });
+    writeFileSync3(snap.cursor, `${nextCursor}
+`);
+  } catch {
+  }
+  const status = ok ? "ok" : failed && !stillRunning ? "failed" : stillRunning ? "running" : "idle";
+  const progress = extra?.progress ?? snap.progress;
+  return {
+    stillRunning,
+    ok,
+    failed: Boolean(failed && !stillRunning && !ok),
+    status,
+    id,
+    pid: snap.pid,
+    exitCode: snap.exitCode ?? void 0,
+    phase: lastProgressLine(progress),
+    delta,
+    progress,
+    hint: stillRunning ? MCP_WAIT_JOB_STILL_RUNNING_HINT : void 0
+  };
 }
-async function allocatePort() {
-  const held = await reservePort();
-  await held.release();
-  return held.port;
+async function sleepMs(ms) {
+  await new Promise((resolve2) => setTimeout(resolve2, ms));
 }
-async function tryReservePort(port) {
-  if (!Number.isInteger(port) || port <= 0 || port > 65535) return null;
-  return new Promise((resolve2) => {
-    const server = createServer();
-    let released = false;
-    const release = () => new Promise((res) => {
-      if (released) {
-        res();
-        return;
-      }
-      released = true;
-      server.close(() => res());
-    });
-    server.once("error", () => {
-      try {
-        server.close();
-      } catch {
-      }
-      resolve2(null);
-    });
-    server.listen(port, "127.0.0.1", () => {
-      resolve2({ port, release });
+async function waitForDetachedJob(cwd, id, opts) {
+  const jobId = sanitizeDetachedJobId(id);
+  const root = cwd.trim() || process.cwd();
+  const dir = resolveJobDir(root, jobId);
+  const timeoutMs = mcpWaitForJobTimeoutMs(opts?.timeoutMs);
+  const sleep = opts?.sleep ?? sleepMs;
+  if (!existsSync3(dir)) {
+    return {
+      stillRunning: false,
+      ok: false,
+      failed: true,
+      status: "failed",
+      id: jobId,
+      delta: "",
+      progress: "No detached job. Start one first.",
+      hint: "Start with detached-job.cjs start <id> -- <command>, then call wait_for_job again."
+    };
+  }
+  const deadline = Date.now() + timeoutMs;
+  let snap = snapshotJob(dir);
+  if (snap.exitCode === 0 && !snap.running) return toResult(jobId, snap);
+  if (!snap.running && snap.pid == null && snap.progress === "(no log yet)") {
+    return toResult(jobId, snap, {
+      failed: true,
+      progress: "No detached job. Start one first."
     });
-  });
+  }
+  while (Date.now() < deadline) {
+    snap = snapshotJob(dir);
+    if (snap.exitCode === 0 && !snap.running) return toResult(jobId, snap);
+    if (!snap.running) return toResult(jobId, snap, { failed: true });
+    await sleep(Math.min(2e3, Math.max(50, deadline - Date.now())));
+  }
+  snap = snapshotJob(dir);
+  return toResult(jobId, snap);
 }
-async function tryReservePorts(ports) {
-  const held = [];
-  for (const port of ports) {
-    const next = await tryReservePort(port);
-    if (!next) {
-      await Promise.all(held.map((h) => h.release()));
-      return null;
+function killProcessTree(pid, signal) {
+  if (!Number.isInteger(pid) || pid <= 0) return;
+  if (process.platform !== "win32") {
+    try {
+      process.kill(-pid, signal);
+      return;
+    } catch {
     }
-    held.push(next);
   }
-  return held;
-}
-function normalizePreferredPorts(ports, size) {
-  if (!ports?.length) return [];
-  const seen = /* @__PURE__ */ new Set();
-  const out = [];
-  for (const p of ports) {
-    if (!Number.isInteger(p) || p <= 0 || p > 65535 || seen.has(p)) continue;
-    seen.add(p);
-    out.push(p);
-    if (out.length >= size) break;
+  try {
+    process.kill(pid, signal);
+  } catch {
   }
-  return out;
-}
-function delay(ms) {
-  return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
-async function fillPortRange(held, size) {
-  if (held.length >= size) return held;
-  const base = held[0]?.port;
-  const taken = new Set(held.map((h) => h.port));
+function appendJobLog(logFile, line) {
   try {
-    let offset = 0;
-    while (held.length < size) {
-      const candidate = base != null ? base + offset : null;
-      offset += 1;
-      if (candidate != null && taken.has(candidate)) continue;
-      const next = candidate != null ? await tryReservePort(candidate) : null;
-      if (next) {
-        held.push(next);
-        taken.add(next.port);
-      } else {
-        const ephemeral = await reservePort();
-        held.push(ephemeral);
-        taken.add(ephemeral.port);
-      }
-    }
-    return held;
-  } catch (err) {
-    await Promise.all(held.map((h) => h.release()));
-    throw err;
+    mkdirSync4(dirname3(logFile), { recursive: true });
+    const body = line.endsWith("\n") ? line : `${line}
+`;
+    appendFileSync2(logFile, body);
+  } catch {
   }
 }
-async function tryReserveAvailablePorts(ports) {
-  const held = [];
-  for (const port of ports) {
-    const next = await tryReservePort(port);
-    if (next) held.push(next);
+async function stopDetachedJob(cwd, id, opts) {
+  const jobId = sanitizeDetachedJobId(id);
+  const root = cwd.trim() || process.cwd();
+  const dir = resolveJobDir(root, jobId);
+  const sleep = opts?.sleep ?? sleepMs;
+  const why = opts?.reason?.trim() ?? "";
+  if (!existsSync3(dir)) {
+    return {
+      stillRunning: false,
+      ok: false,
+      failed: true,
+      status: "failed",
+      id: jobId,
+      delta: "",
+      progress: "No detached job. Start one first.",
+      hint: "Start with detached-job.cjs start <id> -- <command>, then wait_for_job or stop_job.",
+      stopped: false,
+      reason: "not-found"
+    };
   }
-  return held;
-}
-async function reclaimPreferredPorts(ports, worktreePath) {
-  const primary = ports[0];
-  if (primary == null) return null;
-  const takePrimary = async () => {
-    const held2 = await tryReserveAvailablePorts(ports);
-    if (held2.some((h) => h.port === primary)) return held2;
-    await Promise.all(held2.map((h) => h.release()));
-    return null;
-  };
-  let held = await takePrimary();
-  if (held) return held;
-  if (worktreePath) {
-    killStaleWorktreeListeners(ports, worktreePath, "SIGTERM");
-  } else {
-    killListenersOnPorts(ports);
+  let snap = snapshotJob(dir);
+  if (!snap.running) {
+    const result2 = toResult(jobId, snap);
+    return {
+      ...result2,
+      stopped: false,
+      reason: "not-running",
+      hint: "That job is already finished. Read the log; do not wait again unless you start a new command."
+    };
   }
-  for (let i = 0; i < RECLAIM_TRIES; i++) {
-    await delay(RECLAIM_RETRY_DELAY_MS);
-    held = await takePrimary();
-    if (held) return held;
-    if (i === 2 && worktreePath) {
-      killStaleWorktreeListeners(ports, worktreePath, "SIGKILL");
-    }
+  appendJobLog(snap.log, `$ stop${why ? `: ${why}` : ""}`);
+  const targetPid = snap.pid;
+  if (targetPid != null) killProcessTree(targetPid, "SIGTERM");
+  const graceMs = Number.isFinite(opts?.graceMs) ? Math.max(50, opts.graceMs) : 2e3;
+  const deadline = Date.now() + graceMs;
+  while (Date.now() < deadline && jobTreeAlive(targetPid)) {
+    await sleep(Math.min(100, Math.max(20, deadline - Date.now())));
   }
-  return null;
-}
-async function reservePortRange(size = PORT_RANGE_SIZE, opts) {
-  const preferred = normalizePreferredPorts(opts?.preferred, size);
-  if (preferred.length) {
-    const reused = await reclaimPreferredPorts(preferred, opts?.worktreePath);
-    if (reused) return fillPortRange(reused, size);
-  }
-  const held = [await reservePort()];
-  return fillPortRange(held, size);
-}
-async function allocatePortRange(size = PORT_RANGE_SIZE) {
-  const held = await reservePortRange(size);
-  const ports = held.map((h) => h.port);
-  await Promise.all(held.map((h) => h.release()));
-  return ports;
-}
-async function startDevServer(repoPath, worktreePath, onLine, opts) {
-  const script = getRunScript(worktreePath, repoPath, opts?.scriptName);
-  if (!script) return null;
-  const preferred = loadWorktreeRunPorts(worktreePath, script.name) ?? opts?.preferredPorts;
-  const held = await reservePortRange(PORT_RANGE_SIZE, {
-    preferred: preferred ?? void 0,
-    worktreePath
-  });
-  const ports = held.map((h) => h.port);
-  saveWorktreeRunPorts(worktreePath, script.name, ports);
-  try {
-    const handle = await spawnWorkspaceScript(script.command, {
-      worktreePath,
-      repoPath,
-      ports,
-      heldPorts: held,
-      defaultBranch: opts?.defaultBranch,
-      onLine
-    });
-    return {
-      pid: handle.pid,
-      port: ports[0],
-      ports,
-      scriptName: script.name,
-      kill: handle.kill,
-      done: handle.done
-    };
-  } catch (err) {
-    await Promise.all(held.map((h) => h.release()));
-    throw err;
+  if (targetPid != null) {
+    killProcessTree(targetPid, "SIGKILL");
+    await sleep(100);
   }
-}
-
-// src/store/setup-log.ts
-import { createHash } from "crypto";
-import { existsSync as existsSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "fs";
-import { join as join6 } from "path";
-var EMPTY = {
-  output: "",
-  running: false,
-  exitCode: null,
-  source: null
-};
-var MAX_SETUP_LOG_CHARS = 256e3;
-function appendSetupOutput(prev, line, max = MAX_SETUP_LOG_CHARS) {
-  const next = prev ? `${prev}
-${line}` : line;
-  if (next.length <= max) return next;
-  const cut = next.slice(next.length - max);
-  const nl = cut.indexOf("\n");
-  return nl >= 0 && nl < cut.length - 1 ? cut.slice(nl + 1) : cut;
-}
-var memory = /* @__PURE__ */ new Map();
-var persistTimers = /* @__PURE__ */ new Map();
-function fromSnapshot(snap) {
-  return {
-    chunks: snap.output ? [snap.output] : [],
-    length: snap.output.length,
-    running: snap.running,
-    exitCode: snap.exitCode,
-    source: snap.source
-  };
-}
-function materialize(mem) {
-  let output = mem.chunks.join("\n");
-  if (output.length > MAX_SETUP_LOG_CHARS) {
-    output = appendSetupOutput("", output);
-    mem.chunks = [output];
-    mem.length = output.length;
+  const exitFile = join5(dir, "exit");
+  if (!existsSync3(exitFile)) {
+    try {
+      writeFileSync3(exitFile, "1\n");
+    } catch {
+    }
   }
+  snap = snapshotJob(dir);
+  const stillRunning = jobTreeAlive(targetPid) || snap.running;
+  const result = toResult(jobId, snap, { failed: true });
+  const stopped = !stillRunning;
   return {
-    output,
-    running: mem.running,
-    exitCode: mem.exitCode,
-    source: mem.source
+    ...result,
+    stillRunning,
+    ok: false,
+    failed: true,
+    status: stillRunning ? "running" : "failed",
+    stopped,
+    reason: stopped ? "stopped" : "still-running",
+    stopReason: why || void 0,
+    hint: stopped ? MCP_STOP_JOB_HINT : MCP_WAIT_JOB_STILL_RUNNING_HINT
   };
 }
-function setupLogPath(threadId) {
-  return join6(threadsDir(), `${threadId}.setup.log.json`);
-}
-function setupLogKeyForWorktree(worktreePath) {
-  const norm = normalizeWorktreePath(worktreePath);
-  return `wt-${createHash("sha1").update(norm).digest("hex").slice(0, 16)}`;
-}
-function emptySetupLog() {
-  return { ...EMPTY };
+
+// src/hook/conductor.ts
+var PORT_RANGE_SIZE = 10;
+var RECLAIM_RETRY_DELAY_MS = 40;
+var RECLAIM_TRIES = 8;
+function matchSimpleGlob(pattern, name) {
+  const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".");
+  return new RegExp(`^${escaped}$`).test(name);
 }
-function mergeSetupOutput(prev, incoming) {
-  if (!prev) return incoming;
-  if (!incoming) return prev;
-  if (prev === incoming) return prev;
-  if (prev.startsWith(incoming) || prev.endsWith(incoming)) return prev;
-  if (incoming.startsWith(prev) || incoming.endsWith(prev)) return incoming;
-  return incoming.length >= prev.length ? incoming : prev;
+function readWorktreeInclude(repoPath) {
+  const path = join6(repoPath, ".worktreeinclude");
+  if (!existsSync4(path)) return [];
+  return readFileSync4(path, "utf8").split("\n").map((l) => l.trim()).filter((l) => l && !l.startsWith("#"));
 }
-var PERSIST_DEBOUNCE_MS = 500;
-function persistNow(threadId) {
-  const timer = persistTimers.get(threadId);
-  if (timer) {
-    clearTimeout(timer);
-    persistTimers.delete(threadId);
+function resolveFilesToCopy(repoPath) {
+  const fromInclude = readWorktreeInclude(repoPath);
+  if (fromInclude.length) return fromInclude;
+  const settings = loadRepoSettings(repoPath);
+  if (settings?.filesToCopy?.length) return settings.filesToCopy;
+  if (settings?.fileIncludeGlobs?.length) {
+    const matched = [];
+    try {
+      for (const entry of readdirSync2(repoPath, { withFileTypes: true })) {
+        if (!entry.isFile()) continue;
+        for (const glob of settings.fileIncludeGlobs) {
+          if (matchSimpleGlob(glob, entry.name) || matchSimpleGlob(basename(glob), entry.name)) {
+            matched.push(entry.name);
+            break;
+          }
+        }
+      }
+    } catch {
+    }
+    if (matched.length) return [...new Set(matched)];
   }
-  const mem = memory.get(threadId);
-  if (!mem) return;
+  const defaults = [];
   try {
-    writeFileSync3(
-      setupLogPath(threadId),
-      `${JSON.stringify(materialize(mem))}
-`,
-      "utf8"
-    );
+    for (const entry of readdirSync2(repoPath, { withFileTypes: true })) {
+      if (entry.isFile() && entry.name.startsWith(".env")) {
+        defaults.push(entry.name);
+      }
+    }
   } catch {
   }
+  if (defaults.length) return defaults;
+  return [".env.local", ".env"];
 }
-function schedulePersist(threadId) {
-  if (persistTimers.has(threadId)) return;
-  persistTimers.set(
-    threadId,
-    setTimeout(() => {
-      persistTimers.delete(threadId);
-      persistNow(threadId);
-    }, PERSIST_DEBOUNCE_MS)
-  );
+function copyConfiguredFiles(repoPath, worktreePath) {
+  const patterns = resolveFilesToCopy(repoPath);
+  const copied = [];
+  for (const rel of patterns) {
+    const src = join6(repoPath, rel);
+    if (!existsSync4(src)) continue;
+    const dest = join6(worktreePath, rel);
+    mkdirSync5(dirname4(dest), { recursive: true });
+    copyFileSync(src, dest);
+    copied.push(rel);
+  }
+  return copied;
 }
-function loadFromDisk(threadId) {
-  const path = setupLogPath(threadId);
-  if (!existsSync4(path)) return null;
+var cachedLoginEnv = null;
+async function captureLoginEnv() {
+  if (cachedLoginEnv) return { ...cachedLoginEnv };
+  const shell = process.env.SHELL?.trim() || (process.platform === "darwin" ? "/bin/zsh" : "/bin/bash");
   try {
-    const raw = JSON.parse(readFileSync4(path, "utf8"));
-    return {
-      output: typeof raw.output === "string" ? raw.output : "",
-      running: Boolean(raw.running),
-      exitCode: typeof raw.exitCode === "number" ? raw.exitCode : null,
-      source: typeof raw.source === "string" ? raw.source : null
-    };
+    const result = await execa2(shell, ["-l", "-c", "env -0"], {
+      reject: false,
+      timeout: 5e3
+    });
+    if (result.exitCode === 0 && result.stdout) {
+      const env = { ...process.env };
+      for (const entry of result.stdout.split("\0")) {
+        if (!entry) continue;
+        const eq = entry.indexOf("=");
+        if (eq <= 0) continue;
+        const key = entry.slice(0, eq);
+        const value = entry.slice(eq + 1);
+        if (key) env[key] = value;
+      }
+      cachedLoginEnv = env;
+      return { ...env };
+    }
   } catch {
-    return null;
   }
+  cachedLoginEnv = { ...process.env };
+  return { ...cachedLoginEnv };
 }
-function memFor(threadId) {
-  const cached = memory.get(threadId);
-  if (cached) return cached;
-  const mem = fromSnapshot(loadFromDisk(threadId) ?? emptySetupLog());
-  memory.set(threadId, mem);
-  return mem;
+function buildWorkspaceScriptEnv(opts, baseEnv) {
+  const env = stripNestedElectronEnv({
+    ...baseEnv ?? process.env
+  });
+  const name = opts.workspaceName ?? basename(opts.worktreePath);
+  const ports = opts.ports ?? [];
+  const primary = ports[0];
+  env.SIDEBOARD_WORKSPACE_NAME = name;
+  env.SIDEBOARD_WORKSPACE_PATH = opts.worktreePath;
+  env.SIDEBOARD_ROOT_PATH = opts.repoPath;
+  env.SIDEBOARD_IS_LOCAL = "1";
+  if (opts.defaultBranch) env.SIDEBOARD_DEFAULT_BRANCH = opts.defaultBranch;
+  env.CONDUCTOR_WORKSPACE_NAME = name;
+  env.CONDUCTOR_WORKSPACE_PATH = opts.worktreePath;
+  env.CONDUCTOR_ROOT_PATH = opts.repoPath;
+  env.CONDUCTOR_IS_LOCAL = "1";
+  if (opts.defaultBranch) env.CONDUCTOR_DEFAULT_BRANCH = opts.defaultBranch;
+  if (primary != null) {
+    env.SIDEBOARD_PORT = String(primary);
+    env.CONDUCTOR_PORT = String(primary);
+    env.PORT = String(primary);
+    for (let i = 1; i < ports.length; i++) {
+      const p = ports[i];
+      env[`SIDEBOARD_PORT_${i}`] = String(p);
+      env[`CONDUCTOR_PORT_${i}`] = String(p);
+    }
+  }
+  applyWorktreePkgCacheEnv(env, opts.worktreePath);
+  return env;
 }
-function readSetupLog(threadId) {
-  const cached = memory.get(threadId);
-  if (cached) return materialize(cached);
-  const disk = loadFromDisk(threadId);
-  if (disk) {
-    memory.set(threadId, fromSnapshot(disk));
-    return disk;
-  }
-  return emptySetupLog();
-}
-function beginSetupLog(threadId) {
-  const mem = {
-    chunks: [],
-    length: 0,
-    running: true,
-    exitCode: null,
-    source: null
-  };
-  memory.set(threadId, mem);
-  persistNow(threadId);
-  return materialize(mem);
-}
-function appendSetupLog(threadId, line) {
-  const mem = memFor(threadId);
-  mem.chunks.push(line);
-  mem.length += line.length + 1;
-  mem.running = true;
-  if (mem.length > MAX_SETUP_LOG_CHARS * 2) materialize(mem);
-  schedulePersist(threadId);
-}
-function finishSetupLog(threadId, exitCode, source) {
-  const mem = memFor(threadId);
-  mem.running = false;
-  mem.exitCode = exitCode;
-  mem.source = source ?? mem.source;
-  persistNow(threadId);
-  return materialize(mem);
-}
-
-// src/store/run-log.ts
-import { createHash as createHash2 } from "crypto";
-import { existsSync as existsSync5, readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "fs";
-import { join as join7 } from "path";
-var EMPTY2 = {
-  output: "",
-  running: false,
-  exitCode: null,
-  scriptName: null
-};
-var MAX_RUN_LOG_CHARS = 256e3;
-var DEFAULT_RUN_LOG_TAIL_CHARS = 16e3;
-var memory2 = /* @__PURE__ */ new Map();
-var persistTimers2 = /* @__PURE__ */ new Map();
-function fromSnapshot2(snap) {
-  return {
-    chunks: snap.output ? [snap.output] : [],
-    length: snap.output.length,
-    running: snap.running,
-    exitCode: snap.exitCode,
-    scriptName: snap.scriptName
-  };
+function pipeLines(stream, onLine) {
+  if (!stream || !onLine) return;
+  const rl = createInterface2({ input: stream });
+  rl.on("line", onLine);
 }
-function materialize2(mem) {
-  let output = mem.chunks.join("\n");
-  if (output.length > MAX_RUN_LOG_CHARS) {
-    output = appendSetupOutput("", output, MAX_RUN_LOG_CHARS);
-    mem.chunks = [output];
-    mem.length = output.length;
+function killableListenerPids(raw, selfPid = process.pid) {
+  const pids = [];
+  for (const token of raw.trim().split(/\s+/)) {
+    const pid = Number(token);
+    if (!Number.isFinite(pid) || pid <= 0 || pid === selfPid) continue;
+    pids.push(pid);
   }
-  return {
-    output,
-    running: mem.running,
-    exitCode: mem.exitCode,
-    scriptName: mem.scriptName
-  };
-}
-function safeScriptToken(scriptName) {
-  const token = scriptName.replace(/[^a-zA-Z0-9._-]+/g, "_").slice(0, 64);
-  return token || "dev";
+  return pids;
 }
-function runLogPath(key) {
-  return join7(threadsDir(), `${key}.run.log.json`);
+function listUnixListenerPids(port, selfPid) {
+  try {
+    const raw = execFileSync("lsof", [`-tiTCP:${port}`, "-sTCP:LISTEN"], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+      timeout: 2e3
+    });
+    return killableListenerPids(raw, selfPid);
+  } catch {
+    return [];
+  }
 }
-function runLogKeyForWorktree(worktreePath, scriptName) {
-  const norm = normalizeWorktreePath(worktreePath);
-  const hash = createHash2("sha1").update(norm).digest("hex").slice(0, 16);
-  return `wt-${hash}-run-${safeScriptToken(scriptName)}`;
+function listenerCwd(pid) {
+  if (!Number.isFinite(pid) || pid <= 0) return null;
+  try {
+    const raw = execFileSync("lsof", ["-a", "-p", String(pid), "-d", "cwd", "-Fn"], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+      timeout: 2e3
+    });
+    for (const line of raw.split("\n")) {
+      if (line.startsWith("n") && line.length > 1) return line.slice(1);
+    }
+  } catch {
+  }
+  return null;
 }
-function emptyRunLog() {
-  return { ...EMPTY2 };
+function realpathOrResolve(path) {
+  try {
+    return realpathSync(path);
+  } catch {
+    return resolve(path);
+  }
 }
-function sliceRunLogOutput(output, tailChars = DEFAULT_RUN_LOG_TAIL_CHARS) {
-  const max = Math.max(1, tailChars);
-  const outputChars = output.length;
-  if (outputChars <= max) return { output, truncated: false, outputChars };
-  const cut = output.slice(outputChars - max);
-  const nl = cut.indexOf("\n");
-  const text = nl >= 0 && nl < cut.length - 1 ? cut.slice(nl + 1) : cut;
-  return { output: text, truncated: true, outputChars };
+function isOtherWorktreeListenerCwd(cwd, worktreePath) {
+  const wt = realpathOrResolve(worktreePath);
+  const c = realpathOrResolve(cwd);
+  if (c === wt || c.startsWith(wt + sep)) return false;
+  const parent = dirname4(wt);
+  const thisName = basename(wt);
+  if (!thisName || c === parent) return false;
+  if (!c.startsWith(parent + sep)) return false;
+  const first = c.slice(parent.length + 1).split(sep)[0];
+  return Boolean(first) && first !== thisName;
 }
-var PERSIST_DEBOUNCE_MS2 = 500;
-function persistNow2(key) {
-  const timer = persistTimers2.get(key);
-  if (timer) {
-    clearTimeout(timer);
-    persistTimers2.delete(key);
-  }
-  const mem = memory2.get(key);
-  if (!mem) return;
+function signalPid(pid, signal) {
   try {
-    writeFileSync4(runLogPath(key), `${JSON.stringify(materialize2(mem))}
-`, "utf8");
+    process.kill(pid, signal);
   } catch {
   }
 }
-function schedulePersist2(key) {
-  if (persistTimers2.has(key)) return;
-  persistTimers2.set(
-    key,
-    setTimeout(() => {
-      persistTimers2.delete(key);
-      persistNow2(key);
-    }, PERSIST_DEBOUNCE_MS2)
-  );
+function isThisWorktreeListenerCwd(cwd, worktreePath) {
+  const wt = realpathOrResolve(worktreePath);
+  const c = realpathOrResolve(cwd);
+  return c === wt || c.startsWith(wt + sep);
 }
-function loadFromDisk2(key) {
-  const path = runLogPath(key);
-  if (!existsSync5(path)) return null;
+function killDetachedRunTree(pid, worktreePath) {
+  if (!Number.isFinite(pid) || pid <= 1 || pid === process.pid) return;
+  const cwd = listenerCwd(pid);
+  if (cwd) {
+    if (!isThisWorktreeListenerCwd(cwd, worktreePath)) return;
+  } else if (!processGroupAlive(pid)) {
+    return;
+  }
   try {
-    const raw = JSON.parse(readFileSync5(path, "utf8"));
-    return {
-      output: typeof raw.output === "string" ? raw.output : "",
-      running: Boolean(raw.running),
-      exitCode: typeof raw.exitCode === "number" ? raw.exitCode : null,
-      scriptName: typeof raw.scriptName === "string" ? raw.scriptName : null
-    };
+    process.kill(-pid, "SIGTERM");
   } catch {
-    return null;
+    signalPid(pid, "SIGTERM");
   }
 }
-function memFor2(key) {
-  const cached = memory2.get(key);
-  if (cached) return cached;
-  const mem = fromSnapshot2(loadFromDisk2(key) ?? emptyRunLog());
-  memory2.set(key, mem);
-  return mem;
-}
-function readRunLog(key) {
-  const cached = memory2.get(key);
-  if (cached) return materialize2(cached);
-  const disk = loadFromDisk2(key);
-  if (disk) {
-    memory2.set(key, fromSnapshot2(disk));
-    return disk;
+function killListenersOnPorts(ports) {
+  const selfPid = process.pid;
+  for (const port of ports) {
+    if (!Number.isFinite(port) || port <= 0) continue;
+    try {
+      if (process.platform === "win32") {
+        execFileSync(
+          "powershell",
+          [
+            "-NoProfile",
+            "-Command",
+            `Get-NetTCPConnection -LocalPort ${port} -ErrorAction SilentlyContinue | Where-Object { $_.OwningProcess -ne ${selfPid} } | ForEach-Object { Stop-Process -Id $_.OwningProcess -Force -ErrorAction SilentlyContinue }`
+          ],
+          { stdio: "ignore", timeout: 3e3 }
+        );
+        continue;
+      }
+      for (const pid of listUnixListenerPids(port, selfPid)) {
+        signalPid(pid, "SIGTERM");
+      }
+    } catch {
+    }
   }
-  return emptyRunLog();
 }
-function beginRunLog(key, scriptName) {
-  const mem = {
-    chunks: [],
-    length: 0,
-    running: true,
-    exitCode: null,
-    scriptName
-  };
-  memory2.set(key, mem);
-  persistNow2(key);
-  return materialize2(mem);
+function killStaleWorktreeListeners(ports, worktreePath, signal = "SIGTERM") {
+  if (!worktreePath.trim()) {
+    killListenersOnPorts(ports);
+    return;
+  }
+  if (process.platform === "win32") {
+    killListenersOnPorts(ports);
+    return;
+  }
+  const selfPid = process.pid;
+  for (const port of ports) {
+    if (!Number.isFinite(port) || port <= 0) continue;
+    for (const pid of listUnixListenerPids(port, selfPid)) {
+      const cwd = listenerCwd(pid);
+      if (cwd && isOtherWorktreeListenerCwd(cwd, worktreePath)) continue;
+      signalPid(pid, signal);
+    }
+  }
 }
-function appendRunLog(key, line) {
-  const mem = memFor2(key);
-  mem.chunks.push(line);
-  mem.length += line.length + 1;
-  mem.running = true;
-  if (mem.length > MAX_RUN_LOG_CHARS * 2) materialize2(mem);
-  schedulePersist2(key);
-}
-function finishRunLog(key, exitCode) {
-  const mem = memFor2(key);
-  mem.running = false;
-  mem.exitCode = exitCode;
-  persistNow2(key);
-  return materialize2(mem);
-}
-function flushRunLog(key) {
-  persistNow2(key);
-}
-
-// src/git/orphan-cleanup.ts
-import { existsSync as existsSync6, readdirSync as readdirSync2, statSync } from "fs";
-import { join as join8 } from "path";
-function isSideboardWorktreePath(path) {
-  return path.includes("/.sideboard/worktrees/") || path.includes("/sideboard/workspaces/");
-}
-async function findOrphanWorktrees(repoPaths) {
-  const threads = listThreads({ includeArchived: true });
-  const known = new Set(threads.map((t) => t.worktreePath.replace(/\/$/, "")));
-  const repos = new Set(
-    repoPaths?.length ? repoPaths : threads.map((t) => t.repoPath).filter(Boolean)
-  );
-  const homeRoot = sideboardWorkspacesDir();
-  if (existsSync6(homeRoot)) {
-    try {
-      for (const entry of readdirSync2(homeRoot, { withFileTypes: true })) {
-        if (!entry.isDirectory()) continue;
-        void entry;
-      }
-    } catch {
-    }
-  }
-  const orphans = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const repoPath of repos) {
-    if (!repoPath || !existsSync6(repoPath)) continue;
-    try {
-      const wts = await listWorktrees(repoPath);
-      for (const wt of wts) {
-        const path = wt.path.replace(/\/$/, "");
-        if (!isSideboardWorktreePath(path)) continue;
-        if (known.has(path)) continue;
-        if (seen.has(path)) continue;
-        seen.add(path);
-        let mtimeMs = 0;
-        try {
-          mtimeMs = statSync(path).mtimeMs;
-        } catch {
-          mtimeMs = 0;
-        }
-        orphans.push({ path, repoPath, mtimeMs });
-      }
-    } catch {
-    }
+function killScriptTree(child, ports = []) {
+  const pid = child.pid;
+  if (pid) {
     try {
-      const root = worktreesRoot(repoPath);
-      if (existsSync6(root)) {
-        for (const entry of readdirSync2(root, { withFileTypes: true })) {
-          if (!entry.isDirectory()) continue;
-          const path = join8(root, entry.name).replace(/\/$/, "");
-          if (known.has(path) || seen.has(path)) continue;
-          if (!existsSync6(join8(path, ".git"))) continue;
-          seen.add(path);
-          let mtimeMs = 0;
+      if (process.platform === "win32") {
+        void execa2("taskkill", ["/pid", String(pid), "/T", "/F"], { reject: false });
+      } else {
+        process.kill(-pid, "SIGTERM");
+        setTimeout(() => {
           try {
-            mtimeMs = statSync(path).mtimeMs;
+            process.kill(-pid, "SIGKILL");
           } catch {
-            mtimeMs = Date.now();
           }
-          orphans.push({ path, repoPath, mtimeMs });
-        }
+        }, 2500).unref?.();
       }
     } catch {
+      try {
+        child.kill("SIGTERM");
+      } catch {
+      }
     }
   }
-  return orphans.sort((a, b) => a.mtimeMs - b.mtimeMs);
+  killListenersOnPorts(ports);
 }
-async function cleanupOrphanWorktrees(opts) {
-  const settings = loadAppSettings();
-  const maxCount = opts?.maxCount ?? settings.advanced.worktreeMaxCount ?? 25;
-  const orphans = await findOrphanWorktrees(opts?.repoPaths);
-  const activeCount = listThreads().filter((t) => t.status !== "archived").length;
-  const budget = Math.max(0, maxCount - activeCount);
-  const sortedNewestFirst = [...orphans].sort((a, b) => b.mtimeMs - a.mtimeMs);
-  const keep = new Set(sortedNewestFirst.slice(0, budget).map((o) => o.path));
-  const removed = [];
-  const kept = [];
-  for (const orphan of orphans) {
-    if (keep.has(orphan.path)) {
-      kept.push(orphan.path);
-      continue;
-    }
-    if (opts?.dryRun) {
-      removed.push(orphan.path);
-      continue;
-    }
-    try {
-      await removeWorktree(orphan.repoPath, orphan.path);
-      removed.push(orphan.path);
-    } catch {
-      kept.push(orphan.path);
-    }
+async function spawnWorkspaceScript(command, opts) {
+  const loginEnv = await captureLoginEnv();
+  const env = buildWorkspaceScriptEnv(
+    {
+      worktreePath: opts.worktreePath,
+      repoPath: opts.repoPath,
+      workspaceName: opts.workspaceName,
+      defaultBranch: opts.defaultBranch,
+      ports: opts.ports
+    },
+    loginEnv
+  );
+  try {
+    mergeAgentGitAuthEnv(
+      env,
+      await resolveAgentGitAuthEnv(env, { cwd: opts.worktreePath })
+    );
+  } catch {
   }
-  if (!opts?.dryRun) {
-    updateAdvancedSettings({
-      worktreeLastCleanupAt: (/* @__PURE__ */ new Date()).toISOString()
-    });
+  if (opts.heldPorts?.length) {
+    await Promise.all(opts.heldPorts.map((h) => h.release()));
   }
-  return { removed, kept, orphans };
+  const shell = process.platform === "darwin" ? "zsh" : "bash";
+  const child = execa2(shell, ["-lc", command], {
+    cwd: opts.worktreePath,
+    reject: false,
+    env,
+    // Own process group so Stop can tear down the whole tree (not just the shell).
+    // There is no settings.toml `stop=` / teardown hook for run scripts.
+    ...process.platform === "win32" ? {} : { detached: true }
+  });
+  pipeLines(child.stdout, opts.onLine);
+  pipeLines(child.stderr, opts.onLine);
+  const ports = opts.ports ?? [];
+  return {
+    pid: child.pid,
+    kill: () => killScriptTree(child, ports),
+    done: child.then((r) => r.exitCode ?? null),
+    child
+  };
 }
-function shouldRunWorktreeCleanup(settings = loadAppSettings()) {
-  const intervalHours = settings.advanced.worktreeCleanupIntervalHours ?? 6;
-  const last = settings.advanced.worktreeLastCleanupAt;
-  if (!last) return true;
-  const elapsed = Date.now() - Date.parse(last);
-  return elapsed >= intervalHours * 36e5;
+async function attachAbort(handle, signal) {
+  if (signal) {
+    const onAbort = () => handle.kill();
+    if (signal.aborted) onAbort();
+    else signal.addEventListener("abort", onAbort, { once: true });
+  }
+  return handle.done;
 }
-function worktreeCleanupSettings() {
-  const a = loadAppSettings().advanced;
+async function runSetupScript(repoPath, worktreePath, onLine, opts) {
+  const settings = loadWorkspaceSettings(worktreePath, repoPath);
+  if (!settings?.setup) return { ran: false, exitCode: null, source: null };
+  const source = workspaceSettingsSourceLabel(worktreePath, repoPath);
+  onLine?.(`[setup] ${source ?? "settings.toml"}`);
+  const handle = await spawnWorkspaceScript(settings.setup, {
+    worktreePath,
+    repoPath,
+    defaultBranch: opts?.defaultBranch,
+    onLine
+  });
+  const exitCode = await attachAbort(handle, opts?.signal);
   return {
-    worktreeMaxCount: a.worktreeMaxCount,
-    worktreeCleanupIntervalHours: a.worktreeCleanupIntervalHours,
-    worktreeLastCleanupAt: a.worktreeLastCleanupAt,
-    autoCleanupOrphans: a.autoCleanupOrphans
+    ran: true,
+    exitCode,
+    source,
+    kill: handle.kill
   };
 }
-
-// src/store/history-cleanup.ts
-function stripArchivedTranscript(thread) {
-  writeThread(
-    {
-      ...thread,
-      attachments: [],
-      pendingTurnAttachments: [],
-      queueAttachments: [],
-      messages: [historyRetentionStubMessage(thread)]
-    },
-    { touch: false }
-  );
-}
-function cleanupArchivedHistory(opts = {}) {
-  const settings = loadAppSettings();
-  if (!opts.force && opts.purgeOlderThanDays == null && !autoCleanupHistoryEnabled(settings)) {
-    return { stripped: [], purged: [] };
-  }
-  const archived = listThreads({ includeArchived: true }).filter((t) => t.status === "archived");
-  const nowMs = opts.nowMs ?? Date.now();
-  const plan = opts.purgeOlderThanDays != null ? { stripIds: [], purgeIds: planHistoryAgePurge(archived, opts.purgeOlderThanDays, nowMs) } : planHistoryRetention(archived, {
-    maxCount: opts.maxCount ?? historyMaxCount(settings),
-    maxDays: opts.maxDays ?? historyMaxDays(settings),
-    nowMs
+async function runConventionSetup(repoPath, worktreePath, onLine, opts) {
+  const found = findConventionSetup(worktreePath, repoPath);
+  if (!found) return { ran: false, exitCode: null, source: null };
+  onLine?.(`[setup] ${found.source}`);
+  const handle = await spawnWorkspaceScript(found.command, {
+    worktreePath,
+    repoPath,
+    defaultBranch: opts?.defaultBranch,
+    onLine
   });
-  const stripped = [];
-  const purged = [];
-  if (opts.dryRun) {
-    return { stripped: plan.stripIds, purged: plan.purgeIds };
+  const exitCode = await attachAbort(handle, opts?.signal);
+  return {
+    ran: true,
+    exitCode,
+    source: found.source,
+    kill: handle.kill
+  };
+}
+async function runWorkspaceSetup(repoPath, worktreePath, onLine, opts) {
+  await ensureWorktreeSideboardIgnored(worktreePath);
+  const review = ensureReviewGuidelinesFile(worktreePath, repoPath);
+  if (review.wrote) {
+    onLine?.(`[setup] wrote ${review.path} \u2014 local Review guidelines`);
   }
-  for (const id of plan.stripIds) {
-    const thread = readThread(id);
-    if (!thread || thread.status !== "archived") continue;
-    try {
-      stripArchivedTranscript(thread);
-      stripped.push(id);
-    } catch {
-    }
+  let setup = await runSetupScript(repoPath, worktreePath, onLine, opts);
+  if (!setup.ran) {
+    setup = await runCursorWorktreeSetup(repoPath, worktreePath, onLine);
   }
-  for (const id of plan.purgeIds) {
-    const thread = readThread(id);
-    if (!thread || thread.status !== "archived") continue;
-    try {
-      deleteThreadRecord(id);
-      purged.push(id);
-    } catch {
-    }
+  if (!setup.ran) {
+    setup = await runConventionSetup(repoPath, worktreePath, onLine, opts);
   }
-  if (stripped.length > 0 || purged.length > 0) {
-    updateAdvancedSettings({
-      historyLastCleanupAt: new Date(nowMs).toISOString()
-    });
-  }
-  return { stripped, purged };
-}
-function shouldRunHistoryCleanup(settings = loadAppSettings()) {
-  if (!autoCleanupHistoryEnabled(settings)) return false;
-  const intervalHours = settings.advanced.historyCleanupIntervalHours ?? HISTORY_CLEANUP_INTERVAL_HOURS_DEFAULT;
-  const last = settings.advanced.historyLastCleanupAt;
-  if (!last) return true;
-  const elapsed = Date.now() - Date.parse(last);
-  return Number.isFinite(elapsed) && elapsed >= intervalHours * 36e5;
+  return setup;
 }
-
-// src/git/apply-into-main.ts
-import { execa as execa3 } from "execa";
-async function applyThreadIntoMain(thread, opts) {
-  const method = opts?.method ?? "merge";
-  const target = opts?.targetBranch?.trim() || await resolveDefaultBranch(thread.repoPath);
-  const status = await execa3("git", ["status", "--porcelain"], {
-    cwd: thread.repoPath,
-    reject: false
+async function runArchiveScript(repoPath, worktreePath, onLine) {
+  const settings = loadWorkspaceSettings(worktreePath, repoPath);
+  if (!settings?.archive) return { ran: false, exitCode: null };
+  const handle = await spawnWorkspaceScript(settings.archive, {
+    worktreePath,
+    repoPath,
+    onLine
   });
-  if (status.stdout.trim()) {
-    throw new Error(
-      `Main checkout is dirty \u2014 commit or stash before apply-into-main (${thread.repoPath})`
-    );
-  }
-  const checkout = await execa3("git", ["checkout", target], {
-    cwd: thread.repoPath,
-    reject: false
+  const exitCode = await handle.done;
+  return { ran: true, exitCode };
+}
+function listRunScripts(worktreePath, repoPath) {
+  const settings = loadWorkspaceSettings(worktreePath, repoPath);
+  if (!settings?.runScripts.length) return [];
+  return settings.runScripts.filter((s) => {
+    if (!s.availableIn?.length) return true;
+    return s.availableIn.includes("local");
   });
-  if (checkout.exitCode !== 0) {
-    throw new Error(
-      `Failed to checkout ${target}: ${checkout.stderr.trim() || checkout.stdout.trim()}`
-    );
-  }
-  if (method === "cherry-pick") {
-    const log = await execa3(
-      "git",
-      ["log", "--reverse", "--format=%H", `${target}..${thread.branchName}`],
-      { cwd: thread.repoPath, reject: false }
-    );
-    const shas = log.stdout.split("\n").map((s) => s.trim()).filter(Boolean);
-    if (!shas.length) {
-      return {
-        applied: false,
-        method,
-        targetBranch: target,
-        message: `No commits on ${thread.branchName} not already in ${target}`
-      };
-    }
-    for (const sha of shas) {
-      const cp = await execa3("git", ["cherry-pick", sha], {
-        cwd: thread.repoPath,
-        reject: false
-      });
-      if (cp.exitCode !== 0) {
-        await execa3("git", ["cherry-pick", "--abort"], {
-          cwd: thread.repoPath,
-          reject: false
-        });
-        throw new Error(
-          `Cherry-pick ${sha.slice(0, 8)} failed: ${cp.stderr.trim() || cp.stdout.trim()}`
-        );
-      }
-    }
-    return {
-      applied: true,
-      method,
-      targetBranch: target,
-      message: `Cherry-picked ${shas.length} commit(s) from ${thread.branchName} into ${target}`
-    };
-  }
-  const merge = await execa3(
-    "git",
-    ["merge", "--no-ff", "-m", `Apply Sideboard thread ${thread.branchName}`, thread.branchName],
-    { cwd: thread.repoPath, reject: false }
-  );
-  if (merge.exitCode !== 0) {
-    await execa3("git", ["merge", "--abort"], {
-      cwd: thread.repoPath,
-      reject: false
-    });
-    throw new Error(
-      `Merge failed: ${merge.stderr.trim() || merge.stdout.trim()}`
-    );
-  }
-  return {
-    applied: true,
-    method: "merge",
-    targetBranch: target,
-    message: `Merged ${thread.branchName} into ${target} at ${thread.repoPath}`
-  };
 }
-
-// src/git/clone-repo.ts
-import { existsSync as existsSync7 } from "fs";
-import { basename as basename2, join as join9 } from "path";
-import { execa as execa4 } from "execa";
-async function cloneRepoIntoSideboard(opts) {
-  const url = opts.url.trim();
-  if (!url) throw new Error("Clone URL is required");
-  let name = opts.name?.trim();
-  if (!name) {
-    const leaf = basename2(url.replace(/\/$/, "").replace(/\.git$/, ""));
-    name = leaf || "repo";
-  }
-  name = name.replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "repo";
-  const dest = join9(sideboardReposDir(), name);
-  if (existsSync7(dest)) {
-    const repoPath2 = await resolveRepoRoot(dest);
-    const workspace2 = await ensureWorkspace(repoPath2);
-    return { repoPath: repoPath2, workspace: workspace2 };
-  }
-  const result = await execa4("git", ["clone", url, dest], { reject: false });
-  if (result.exitCode !== 0) {
-    throw new Error(
-      `git clone failed: ${result.stderr?.trim() || result.stdout?.trim() || `exit ${result.exitCode}`}`
-    );
-  }
-  const repoPath = await resolveRepoRoot(dest);
-  const workspace = await ensureWorkspace(repoPath);
-  return { repoPath, workspace };
+function getDefaultRunScript(worktreePath, repoPath) {
+  const scripts = listRunScripts(worktreePath, repoPath);
+  if (!scripts.length) return null;
+  return scripts.find((s) => s.default === true) ?? scripts.find((s) => s.name === "dev") ?? scripts.find((s) => s.name !== "all") ?? scripts[0] ?? null;
 }
-
-// src/types/thread.ts
-function isUnclaimedRunScriptRequest(req) {
-  return Boolean(req && !req.claimedAt && !req.fulfilledAt && !req.error);
+function getRunScript(worktreePath, repoPath, name) {
+  const scripts = listRunScripts(worktreePath, repoPath);
+  if (!scripts.length) return null;
+  if (name) {
+    return scripts.find((s) => s.name === name) ?? null;
+  }
+  return getDefaultRunScript(worktreePath, repoPath);
 }
-function isAdoptableRunScriptRequest(req) {
-  return Boolean(req && !req.fulfilledAt && !req.error);
+function getRunMode(worktreePath, repoPath) {
+  return loadWorkspaceSettings(worktreePath, repoPath)?.runMode ?? "concurrent";
 }
-
-// src/store/desktop-host.ts
-import { readFileSync as readFileSync6, unlinkSync, writeFileSync as writeFileSync5 } from "fs";
-import { join as join10 } from "path";
-function desktopHostPidPath() {
-  return join10(appDataDir(), "desktop-host.pid");
+async function reservePort() {
+  return new Promise((resolve2, reject) => {
+    const server = createServer();
+    let released = false;
+    const release = () => new Promise((res) => {
+      if (released) {
+        res();
+        return;
+      }
+      released = true;
+      server.close(() => res());
+    });
+    server.listen(0, "127.0.0.1", () => {
+      const addr = server.address();
+      if (!addr || typeof addr === "string") {
+        void release().then(() => reject(new Error("Failed to allocate port")));
+        return;
+      }
+      resolve2({ port: addr.port, release });
+    });
+    server.on("error", reject);
+  });
 }
-function claimDesktopHost(pid = process.pid) {
-  writeFileSync5(desktopHostPidPath(), `${pid}
-`, "utf8");
+async function allocatePort() {
+  const held = await reservePort();
+  await held.release();
+  return held.port;
 }
-function releaseDesktopHost(pid = process.pid) {
-  if (readDesktopHostPid() !== pid) return;
-  try {
-    unlinkSync(desktopHostPidPath());
-  } catch {
-  }
+async function tryReservePort(port) {
+  if (!Number.isInteger(port) || port <= 0 || port > 65535) return null;
+  return new Promise((resolve2) => {
+    const server = createServer();
+    let released = false;
+    const release = () => new Promise((res) => {
+      if (released) {
+        res();
+        return;
+      }
+      released = true;
+      server.close(() => res());
+    });
+    server.once("error", () => {
+      try {
+        server.close();
+      } catch {
+      }
+      resolve2(null);
+    });
+    server.listen(port, "127.0.0.1", () => {
+      resolve2({ port, release });
+    });
+  });
 }
-function readDesktopHostPid() {
-  try {
-    const pid = Number.parseInt(readFileSync6(desktopHostPidPath(), "utf8").trim(), 10);
-    if (!Number.isFinite(pid) || pid <= 0) return null;
-    return pid;
-  } catch {
-    return null;
+async function tryReservePorts(ports) {
+  const held = [];
+  for (const port of ports) {
+    const next = await tryReservePort(port);
+    if (!next) {
+      await Promise.all(held.map((h) => h.release()));
+      return null;
+    }
+    held.push(next);
   }
+  return held;
 }
-function pidAlive(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch {
-    return false;
+function normalizePreferredPorts(ports, size) {
+  if (!ports?.length) return [];
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const p of ports) {
+    if (!Number.isInteger(p) || p <= 0 || p > 65535 || seen.has(p)) continue;
+    seen.add(p);
+    out.push(p);
+    if (out.length >= size) break;
   }
+  return out;
 }
-function isDesktopHostAlive() {
-  const pid = readDesktopHostPid();
-  return pid != null && pidAlive(pid);
-}
-function isThisProcessDesktopHost() {
-  return readDesktopHostPid() === process.pid && pidAlive(process.pid);
-}
-function thisProcessShouldDrainAgentQueues() {
-  if (isThisProcessDesktopHost()) return true;
-  return !isDesktopHostAlive();
+function delay(ms) {
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
-
-// src/orchestrator/child-halt.ts
-var HALT_STATUSES = /* @__PURE__ */ new Set(["stopped", "error", "broken"]);
-function isIncompleteChildStatus(status) {
-  return HALT_STATUSES.has(status);
+async function fillPortRange(held, size) {
+  if (held.length >= size) return held;
+  const base = held[0]?.port;
+  const taken = new Set(held.map((h) => h.port));
+  try {
+    let offset = 0;
+    while (held.length < size) {
+      const candidate = base != null ? base + offset : null;
+      offset += 1;
+      if (candidate != null && taken.has(candidate)) continue;
+      const next = candidate != null ? await tryReservePort(candidate) : null;
+      if (next) {
+        held.push(next);
+        taken.add(next.port);
+      } else {
+        const ephemeral = await reservePort();
+        held.push(ephemeral);
+        taken.add(ephemeral.port);
+      }
+    }
+    return held;
+  } catch (err) {
+    await Promise.all(held.map((h) => h.release()));
+    throw err;
+  }
 }
-function childHaltNotice(child, status) {
-  const title = child.title?.trim() || "Untitled";
-  const link = `[${title}](sideboard://thread/${child.id})`;
-  const why = child.lastError?.trim();
-  const extra = why ? ` lastError: ${why}` : "";
-  return [
-    `Sideboard: child worktree ${link} ${status} before finishing (status=${status}).${extra}`,
-    "This is information \u2014 not a user command. Resume with send_to_thread or tell the user. Do not treat this as a successful turn."
-  ].join("\n");
+async function tryReserveAvailablePorts(ports) {
+  const held = [];
+  for (const port of ports) {
+    const next = await tryReservePort(port);
+    if (next) held.push(next);
+  }
+  return held;
 }
-function shouldNotifyParentAfterTurnError(opts) {
-  return !opts.quotaFailoverHandled && !opts.crashContinued;
+async function reclaimPreferredPorts(ports, worktreePath) {
+  const primary = ports[0];
+  if (primary == null) return null;
+  const takePrimary = async () => {
+    const held2 = await tryReserveAvailablePorts(ports);
+    if (held2.some((h) => h.port === primary)) return held2;
+    await Promise.all(held2.map((h) => h.release()));
+    return null;
+  };
+  let held = await takePrimary();
+  if (held) return held;
+  if (worktreePath) {
+    killStaleWorktreeListeners(ports, worktreePath, "SIGTERM");
+  } else {
+    killListenersOnPorts(ports);
+  }
+  for (let i = 0; i < RECLAIM_TRIES; i++) {
+    await delay(RECLAIM_RETRY_DELAY_MS);
+    held = await takePrimary();
+    if (held) return held;
+    if (i === 2 && worktreePath) {
+      killStaleWorktreeListeners(ports, worktreePath, "SIGKILL");
+    }
+  }
+  return null;
 }
-function shouldNotifyParentOfChildHalt(opts) {
-  if (!isIncompleteChildStatus(opts.status)) return false;
-  if (!opts.child.parentThreadId) return false;
-  if (!opts.parent || opts.parent.status === "archived") return false;
-  if (opts.parent.id === opts.child.id) return false;
-  return isOrchestratorThread(opts.parent);
+async function reservePortRange(size = PORT_RANGE_SIZE, opts) {
+  const preferred = normalizePreferredPorts(opts?.preferred, size);
+  if (preferred.length) {
+    const reused = await reclaimPreferredPorts(preferred, opts?.worktreePath);
+    if (reused) return fillPortRange(reused, size);
+  }
+  const held = [await reservePort()];
+  return fillPortRange(held, size);
 }
-var notified = /* @__PURE__ */ new Set();
-function noticeKey(childId, status) {
-  return `${childId}:${status}`;
+async function allocatePortRange(size = PORT_RANGE_SIZE) {
+  const held = await reservePortRange(size);
+  const ports = held.map((h) => h.port);
+  await Promise.all(held.map((h) => h.release()));
+  return ports;
 }
-function notifyParentOfChildHalt(child, status, send) {
-  const parent = child.parentThreadId ? readThread(child.parentThreadId) : null;
-  if (!shouldNotifyParentOfChildHalt({ child, parent, status })) return false;
-  const key = noticeKey(child.id, status);
-  if (notified.has(key)) return false;
-  notified.add(key);
-  const parentId = parent.id;
-  void send(parentId, childHaltNotice(child, status)).catch(() => {
-    notified.delete(key);
+async function startDevServer(repoPath, worktreePath, onLine, opts) {
+  const script = getRunScript(worktreePath, repoPath, opts?.scriptName);
+  if (!script) return null;
+  const preferred = loadWorktreeRunPorts(worktreePath, script.name) ?? opts?.preferredPorts;
+  const held = await reservePortRange(PORT_RANGE_SIZE, {
+    preferred: preferred ?? void 0,
+    worktreePath
   });
-  return true;
-}
-
-// src/mcp/wait-for-job.ts
-import {
-  appendFileSync as appendFileSync2,
-  existsSync as existsSync8,
-  mkdirSync as mkdirSync5,
-  readdirSync as readdirSync3,
-  readFileSync as readFileSync7,
-  writeFileSync as writeFileSync6
-} from "fs";
-import { dirname as dirname4, join as join11 } from "path";
-
-// src/mcp/wait-for-turn.ts
-var MCP_WAIT_FOR_TURN_MAX_MS = 45e3;
-function mcpWaitForTurnTimeoutMs(requested) {
-  const n = requested ?? MCP_WAIT_FOR_TURN_MAX_MS;
-  if (!Number.isFinite(n)) return MCP_WAIT_FOR_TURN_MAX_MS;
-  return Math.min(Math.max(1e3, Math.floor(n)), MCP_WAIT_FOR_TURN_MAX_MS);
-}
-var MCP_WAIT_STILL_RUNNING_HINT = "Child is still working. Call wait_for_turn again. Do not send_to_thread a check-in (that steers / interrupts) or assume a hang while progress is updating.";
-var MCP_WAIT_QUEUED_HINT = "Child is queued waiting for a concurrency slot \u2014 it has not started yet. Call wait_for_turn again. Do not send_to_thread a check-in (that steers / interrupts), force_stop, or assume it failed to start.";
-var MCP_WAIT_STOPPED_HINT = "Child was stopped before the turn finished. Do not treat this as success. send_to_thread to resume, or tell the user.";
-var MCP_WAIT_BROKEN_HINT = "Child worktree is broken (missing on disk). Tell the user \u2014 do not treat this as success.";
-var MCP_WAIT_ERROR_HINT = "Child turn failed. lastError/text is the failure \u2014 switch agent, tell the user, or retry. Do not treat empty text as success.";
-var MCP_WAIT_INPUT_REQUIRED_HINT = "Child asked the user a question (ask_user). taskState is input-required. Wait for the user to answer in that chat \u2014 do not send_to_thread a check-in.";
-function mcpWaitTaskHint(taskState, status) {
-  switch (taskState) {
-    case "submitted":
-      return MCP_WAIT_QUEUED_HINT;
-    case "working":
-      return MCP_WAIT_STILL_RUNNING_HINT;
-    case "input-required":
-      return MCP_WAIT_INPUT_REQUIRED_HINT;
-    case "canceled":
-      return MCP_WAIT_STOPPED_HINT;
-    case "failed":
-      return status === "broken" ? MCP_WAIT_BROKEN_HINT : MCP_WAIT_ERROR_HINT;
-    default:
-      return void 0;
+  const ports = held.map((h) => h.port);
+  saveWorktreeRunPorts(worktreePath, script.name, ports);
+  try {
+    const handle = await spawnWorkspaceScript(script.command, {
+      worktreePath,
+      repoPath,
+      ports,
+      heldPorts: held,
+      defaultBranch: opts?.defaultBranch,
+      onLine
+    });
+    return {
+      pid: handle.pid,
+      port: ports[0],
+      ports,
+      scriptName: script.name,
+      kill: handle.kill,
+      done: handle.done
+    };
+  } catch (err) {
+    await Promise.all(held.map((h) => h.release()));
+    throw err;
   }
 }
 
-// src/mcp/wait-for-job.ts
-var MAX_JOB_CONTINUES = 8;
-var MAX_JOB_DELTA_LINES = 80;
-var MAX_JOB_DELTA_CHARS = 4e3;
-var DEFERRED_DONE_MAX_CHARS = 480;
-var GH_WATCH_REFRESH = "Refreshing run status every 3 seconds.";
-var MCP_WAIT_JOB_STILL_RUNNING_HINT = "Job is still running. The type=log pane already appended this delta. Call wait_for_job again. If it is hanging, producing no useful output, or doing the wrong thing, call stop_job (same id) instead of looping forever. Do not end the turn or tell the user you will let them know later.";
-var MCP_STOP_JOB_HINT = "Stopped. The type=log pane is status=failed with the last delta. Do not wait again unless you start a new command.";
-var JOB_ID_RE = /^[a-zA-Z0-9._-]{1,64}$/;
-function mcpWaitForJobTimeoutMs(requested) {
-  return mcpWaitForTurnTimeoutMs(requested);
-}
-function sanitizeDetachedJobId(id) {
-  const s = id.trim();
-  if (!JOB_ID_RE.test(s)) {
-    throw new Error(`detached-job id must be 1\u201364 chars [A-Za-z0-9._-], got ${JSON.stringify(id)}`);
-  }
-  return s;
+// src/store/setup-log.ts
+import { createHash } from "crypto";
+import { existsSync as existsSync5, readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "fs";
+import { join as join7 } from "path";
+var EMPTY = {
+  output: "",
+  running: false,
+  exitCode: null,
+  source: null
+};
+var MAX_SETUP_LOG_CHARS = 256e3;
+function appendSetupOutput(prev, line, max = MAX_SETUP_LOG_CHARS) {
+  const next = prev ? `${prev}
+${line}` : line;
+  if (next.length <= max) return next;
+  const cut = next.slice(next.length - max);
+  const nl = cut.indexOf("\n");
+  return nl >= 0 && nl < cut.length - 1 ? cut.slice(nl + 1) : cut;
 }
-function jobAlive(pid) {
-  if (!Number.isInteger(pid) || pid <= 0) return false;
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch {
-    return false;
-  }
+var memory = /* @__PURE__ */ new Map();
+var persistTimers = /* @__PURE__ */ new Map();
+function fromSnapshot(snap) {
+  return {
+    chunks: snap.output ? [snap.output] : [],
+    length: snap.output.length,
+    running: snap.running,
+    exitCode: snap.exitCode,
+    source: snap.source
+  };
 }
-function processGroupAlive(pgid) {
-  if (process.platform === "win32") return false;
-  if (!Number.isInteger(pgid) || pgid <= 1) return false;
-  try {
-    process.kill(-pgid, 0);
-    return true;
-  } catch (err) {
-    return err && typeof err === "object" && "code" in err && err.code === "EPERM";
+function materialize(mem) {
+  let output = mem.chunks.join("\n");
+  if (output.length > MAX_SETUP_LOG_CHARS) {
+    output = appendSetupOutput("", output);
+    mem.chunks = [output];
+    mem.length = output.length;
   }
+  return {
+    output,
+    running: mem.running,
+    exitCode: mem.exitCode,
+    source: mem.source
+  };
 }
-function jobTreeAlive(pid) {
-  if (pid == null) return false;
-  return jobAlive(pid) || processGroupAlive(pid);
+function setupLogPath(threadId) {
+  return join7(threadsDir(), `${threadId}.setup.log.json`);
 }
-function readIntFile(file) {
-  if (!existsSync8(file)) return null;
-  const n = Number.parseInt(readFileSync7(file, "utf8").trim(), 10);
-  return Number.isInteger(n) ? n : null;
+function setupLogKeyForWorktree(worktreePath) {
+  const norm = normalizeWorktreePath(worktreePath);
+  return `wt-${createHash("sha1").update(norm).digest("hex").slice(0, 16)}`;
 }
-function jobDir(root, id, legacy = false) {
-  return join11(root, legacy ? LEGACY_DETACHED_JOBS_DIR : DETACHED_JOBS_DIR, id);
+function emptySetupLog() {
+  return { ...EMPTY };
 }
-function resolveJobDir(root, id) {
-  const modern = jobDir(root, id, false);
-  if (existsSync8(modern)) return modern;
-  const legacy = jobDir(root, id, true);
-  if (existsSync8(legacy)) return legacy;
-  return modern;
+function mergeSetupOutput(prev, incoming) {
+  if (!prev) return incoming;
+  if (!incoming) return prev;
+  if (prev === incoming) return prev;
+  if (prev.startsWith(incoming) || prev.endsWith(incoming)) return prev;
+  if (incoming.startsWith(prev) || incoming.endsWith(prev)) return incoming;
+  return incoming.length >= prev.length ? incoming : prev;
 }
-function listJobIdsIn(root, rel) {
-  const dir = join11(root, rel);
-  if (!existsSync8(dir)) return [];
-  return readdirSync3(dir, { withFileTypes: true }).filter((e) => e.isDirectory() && JOB_ID_RE.test(e.name)).map((e) => e.name);
+var PERSIST_DEBOUNCE_MS = 500;
+function persistNow(threadId) {
+  const timer = persistTimers.get(threadId);
+  if (timer) {
+    clearTimeout(timer);
+    persistTimers.delete(threadId);
+  }
+  const mem = memory.get(threadId);
+  if (!mem) return;
+  try {
+    writeFileSync4(
+      setupLogPath(threadId),
+      `${JSON.stringify(materialize(mem))}
+`,
+      "utf8"
+    );
+  } catch {
+  }
 }
-function listRunningDetachedJobs(worktreePath) {
-  const root = worktreePath.trim();
-  if (!root) return [];
-  const ids = /* @__PURE__ */ new Set([
-    ...listJobIdsIn(root, DETACHED_JOBS_DIR),
-    ...listJobIdsIn(root, LEGACY_DETACHED_JOBS_DIR)
-  ]);
-  const running = [];
-  for (const id of ids) {
-    const dir = resolveJobDir(root, id);
-    const pid = readIntFile(join11(dir, "pid"));
-    if (jobTreeAlive(pid)) running.push(id);
+function schedulePersist(threadId) {
+  if (persistTimers.has(threadId)) return;
+  persistTimers.set(
+    threadId,
+    setTimeout(() => {
+      persistTimers.delete(threadId);
+      persistNow(threadId);
+    }, PERSIST_DEBOUNCE_MS)
+  );
+}
+function loadFromDisk(threadId) {
+  const path = setupLogPath(threadId);
+  if (!existsSync5(path)) return null;
+  try {
+    const raw = JSON.parse(readFileSync5(path, "utf8"));
+    return {
+      output: typeof raw.output === "string" ? raw.output : "",
+      running: Boolean(raw.running),
+      exitCode: typeof raw.exitCode === "number" ? raw.exitCode : null,
+      source: typeof raw.source === "string" ? raw.source : null
+    };
+  } catch {
+    return null;
   }
-  return running.sort();
 }
-function looksLikeDeferredDonePromise(text) {
-  const t = (text ?? "").trim();
-  if (!t || t.length > DEFERRED_DONE_MAX_CHARS) return false;
-  const unquoted = t.replace(/`[^`]*`/g, " ").replace(/["“”][^"“”]*["“”]/g, " ").replace(/\s+/g, " ").trim();
-  if (!unquoted) return false;
-  return /\b(i['’]?ll|i will)\s+let you know\b/i.test(unquoted) || /\blet you know when\b/i.test(unquoted) || /\b(check back|ping me)\s+when\b/i.test(unquoted) || /\bi(?:['’]ll| will)\s+(report|update you)\s+when\b/i.test(unquoted);
+function memFor(threadId) {
+  const cached = memory.get(threadId);
+  if (cached) return cached;
+  const mem = fromSnapshot(loadFromDisk(threadId) ?? emptySetupLog());
+  memory.set(threadId, mem);
+  return mem;
 }
-function isJobContinuePrompt(text) {
-  if (typeof text !== "string") return false;
-  const t = text.trim();
-  return t.startsWith("Detached job still running:") || t.startsWith("You ended the turn after promising to report later");
+function readSetupLog(threadId) {
+  const cached = memory.get(threadId);
+  if (cached) return materialize(cached);
+  const disk = loadFromDisk(threadId);
+  if (disk) {
+    memory.set(threadId, fromSnapshot(disk));
+    return disk;
+  }
+  return emptySetupLog();
 }
-function collapseGhRunWatchLog(text) {
-  if (!text.includes(GH_WATCH_REFRESH)) return text;
-  const frames = text.split(/(?=Refreshing run status every 3 seconds\.)/);
-  const watchFrames = frames.filter((f) => f.includes(GH_WATCH_REFRESH));
-  if (watchFrames.length <= 1) return text;
-  const prefix = frames[0]?.includes(GH_WATCH_REFRESH) ? "" : frames[0] ?? "";
-  const last = watchFrames[watchFrames.length - 1] ?? "";
-  const omitted = watchFrames.length - 1;
-  const note = `(${omitted} identical gh run watch refresh${omitted === 1 ? "" : "es"} omitted)
-`;
-  return [prefix.trimEnd(), note, last.trimStart()].filter(Boolean).join("\n");
+function beginSetupLog(threadId) {
+  const mem = {
+    chunks: [],
+    length: 0,
+    running: true,
+    exitCode: null,
+    source: null
+  };
+  memory.set(threadId, mem);
+  persistNow(threadId);
+  return materialize(mem);
 }
-function capJobLogDelta(text) {
-  const collapsed = collapseGhRunWatchLog(text);
-  const lines = collapsed.split("\n");
-  let out = lines.length > MAX_JOB_DELTA_LINES ? `\u2026(${lines.length - MAX_JOB_DELTA_LINES} earlier lines omitted)
-${lines.slice(-MAX_JOB_DELTA_LINES).join("\n")}` : collapsed;
-  if (out.length > MAX_JOB_DELTA_CHARS) {
-    out = `\u2026(truncated ${out.length} chars)
-${out.slice(-MAX_JOB_DELTA_CHARS)}`;
+function appendSetupLog(threadId, line) {
+  const mem = memFor(threadId);
+  mem.chunks.push(line);
+  mem.length += line.length + 1;
+  mem.running = true;
+  if (mem.length > MAX_SETUP_LOG_CHARS * 2) materialize(mem);
+  schedulePersist(threadId);
+}
+function finishSetupLog(threadId, exitCode, source) {
+  const mem = memFor(threadId);
+  mem.running = false;
+  mem.exitCode = exitCode;
+  mem.source = source ?? mem.source;
+  persistNow(threadId);
+  return materialize(mem);
+}
+
+// src/store/run-log.ts
+import { createHash as createHash2 } from "crypto";
+import { existsSync as existsSync6, readFileSync as readFileSync6, writeFileSync as writeFileSync5 } from "fs";
+import { join as join8 } from "path";
+var EMPTY2 = {
+  output: "",
+  running: false,
+  exitCode: null,
+  scriptName: null
+};
+var MAX_RUN_LOG_CHARS = 256e3;
+var DEFAULT_RUN_LOG_TAIL_CHARS = 16e3;
+var memory2 = /* @__PURE__ */ new Map();
+var persistTimers2 = /* @__PURE__ */ new Map();
+function fromSnapshot2(snap) {
+  return {
+    chunks: snap.output ? [snap.output] : [],
+    length: snap.output.length,
+    running: snap.running,
+    exitCode: snap.exitCode,
+    scriptName: snap.scriptName
+  };
+}
+function materialize2(mem) {
+  let output = mem.chunks.join("\n");
+  if (output.length > MAX_RUN_LOG_CHARS) {
+    output = appendSetupOutput("", output, MAX_RUN_LOG_CHARS);
+    mem.chunks = [output];
+    mem.length = output.length;
   }
-  return out;
+  return {
+    output,
+    running: mem.running,
+    exitCode: mem.exitCode,
+    scriptName: mem.scriptName
+  };
 }
-function formatJobStillRunningContinuePrompt(jobIds) {
-  const ids = jobIds.join(", ");
-  return [
-    `Detached job still running: ${ids}.`,
-    "Do not end this turn. Loop wait_for_job (same id) until stillRunning is false. The log pane updates from each wait result.",
-    "If the job is hanging or doing the wrong thing, call stop_job (same id) instead of looping forever.",
-    "Then report the result. Do not tell the user you will let them know later."
-  ].join(" ");
+function safeScriptToken(scriptName) {
+  const token = scriptName.replace(/[^a-zA-Z0-9._-]+/g, "_").slice(0, 64);
+  return token || "dev";
 }
-function formatDeferredDoneContinuePrompt() {
-  return [
-    "You ended the turn after promising to report later, but no detached job is running.",
-    "If tests/pack/deploy still need to run: start once with detached-job.cjs, then loop wait_for_job until stillRunning is false (the log pane updates from wait JSON).",
-    "Do not say you will let the user know later."
-  ].join(" ");
+function runLogPath(key) {
+  return join8(threadsDir(), `${key}.run.log.json`);
 }
-function turnWatchedDetachedJob(parts) {
-  return parts.some((p) => {
-    if (p.type !== "tool") return false;
-    if (/wait_for_job$/i.test(p.name ?? "") || /stop_job$/i.test(p.name ?? "")) return true;
-    const blob = [p.name, p.detail, p.description, p.input ? JSON.stringify(p.input) : ""].filter(Boolean).join(" ");
-    return /detached-job\.(?:js|cjs)\b/i.test(blob);
-  });
+function runLogKeyForWorktree(worktreePath, scriptName) {
+  const norm = normalizeWorktreePath(worktreePath);
+  const hash = createHash2("sha1").update(norm).digest("hex").slice(0, 16);
+  return `wt-${hash}-run-${safeScriptToken(scriptName)}`;
 }
-function planJobContinue(opts) {
-  if (opts.isOrchestrator) return { action: "none" };
-  if (opts.agent === "brightsy") return { action: "none" };
-  if (opts.queueLength > 0) return { action: "none" };
-  if (opts.continueCount >= MAX_JOB_CONTINUES) return { action: "none" };
-  const farewell = looksLikeDeferredDonePromise(opts.chatText);
-  if (opts.runningJobIds.length > 0 && (farewell || opts.watchedJob)) {
+function emptyRunLog() {
+  return { ...EMPTY2 };
+}
+function sliceRunLogOutput(output, tailChars = DEFAULT_RUN_LOG_TAIL_CHARS) {
+  const max = Math.max(1, tailChars);
+  const outputChars = output.length;
+  if (outputChars <= max) return { output, truncated: false, outputChars };
+  const cut = output.slice(outputChars - max);
+  const nl = cut.indexOf("\n");
+  const text = nl >= 0 && nl < cut.length - 1 ? cut.slice(nl + 1) : cut;
+  return { output: text, truncated: true, outputChars };
+}
+var PERSIST_DEBOUNCE_MS2 = 500;
+function persistNow2(key) {
+  const timer = persistTimers2.get(key);
+  if (timer) {
+    clearTimeout(timer);
+    persistTimers2.delete(key);
+  }
+  const mem = memory2.get(key);
+  if (!mem) return;
+  try {
+    writeFileSync5(runLogPath(key), `${JSON.stringify(materialize2(mem))}
+`, "utf8");
+  } catch {
+  }
+}
+function schedulePersist2(key) {
+  if (persistTimers2.has(key)) return;
+  persistTimers2.set(
+    key,
+    setTimeout(() => {
+      persistTimers2.delete(key);
+      persistNow2(key);
+    }, PERSIST_DEBOUNCE_MS2)
+  );
+}
+function loadFromDisk2(key) {
+  const path = runLogPath(key);
+  if (!existsSync6(path)) return null;
+  try {
+    const raw = JSON.parse(readFileSync6(path, "utf8"));
     return {
-      action: "wait",
-      jobIds: opts.runningJobIds,
-      prompt: formatJobStillRunningContinuePrompt(opts.runningJobIds)
+      output: typeof raw.output === "string" ? raw.output : "",
+      running: Boolean(raw.running),
+      exitCode: typeof raw.exitCode === "number" ? raw.exitCode : null,
+      scriptName: typeof raw.scriptName === "string" ? raw.scriptName : null
     };
+  } catch {
+    return null;
   }
-  if (looksLikeDeferredDonePromise(opts.chatText) && !opts.alreadyNudged) {
-    return { action: "nudge", prompt: formatDeferredDoneContinuePrompt() };
+}
+function memFor2(key) {
+  const cached = memory2.get(key);
+  if (cached) return cached;
+  const mem = fromSnapshot2(loadFromDisk2(key) ?? emptyRunLog());
+  memory2.set(key, mem);
+  return mem;
+}
+function readRunLog(key) {
+  const cached = memory2.get(key);
+  if (cached) return materialize2(cached);
+  const disk = loadFromDisk2(key);
+  if (disk) {
+    memory2.set(key, fromSnapshot2(disk));
+    return disk;
+  }
+  return emptyRunLog();
+}
+function beginRunLog(key, scriptName) {
+  const mem = {
+    chunks: [],
+    length: 0,
+    running: true,
+    exitCode: null,
+    scriptName
+  };
+  memory2.set(key, mem);
+  persistNow2(key);
+  return materialize2(mem);
+}
+function appendRunLog(key, line) {
+  const mem = memFor2(key);
+  mem.chunks.push(line);
+  mem.length += line.length + 1;
+  mem.running = true;
+  if (mem.length > MAX_RUN_LOG_CHARS * 2) materialize2(mem);
+  schedulePersist2(key);
+}
+function finishRunLog(key, exitCode) {
+  const mem = memFor2(key);
+  mem.running = false;
+  mem.exitCode = exitCode;
+  persistNow2(key);
+  return materialize2(mem);
+}
+function flushRunLog(key) {
+  persistNow2(key);
+}
+
+// src/git/orphan-cleanup.ts
+import { existsSync as existsSync7, readdirSync as readdirSync3, statSync } from "fs";
+import { join as join9 } from "path";
+function isSideboardWorktreePath(path) {
+  return path.includes("/.sideboard/worktrees/") || path.includes("/sideboard/workspaces/");
+}
+async function findOrphanWorktrees(repoPaths) {
+  const threads = listThreads({ includeArchived: true });
+  const known = new Set(threads.map((t) => t.worktreePath.replace(/\/$/, "")));
+  const repos = new Set(
+    repoPaths?.length ? repoPaths : threads.map((t) => t.repoPath).filter(Boolean)
+  );
+  const homeRoot = sideboardWorkspacesDir();
+  if (existsSync7(homeRoot)) {
+    try {
+      for (const entry of readdirSync3(homeRoot, { withFileTypes: true })) {
+        if (!entry.isDirectory()) continue;
+        void entry;
+      }
+    } catch {
+    }
+  }
+  const orphans = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const repoPath of repos) {
+    if (!repoPath || !existsSync7(repoPath)) continue;
+    try {
+      const wts = await listWorktrees(repoPath);
+      for (const wt of wts) {
+        const path = wt.path.replace(/\/$/, "");
+        if (!isSideboardWorktreePath(path)) continue;
+        if (known.has(path)) continue;
+        if (seen.has(path)) continue;
+        seen.add(path);
+        let mtimeMs = 0;
+        try {
+          mtimeMs = statSync(path).mtimeMs;
+        } catch {
+          mtimeMs = 0;
+        }
+        orphans.push({ path, repoPath, mtimeMs });
+      }
+    } catch {
+    }
+    try {
+      const root = worktreesRoot(repoPath);
+      if (existsSync7(root)) {
+        for (const entry of readdirSync3(root, { withFileTypes: true })) {
+          if (!entry.isDirectory()) continue;
+          const path = join9(root, entry.name).replace(/\/$/, "");
+          if (known.has(path) || seen.has(path)) continue;
+          if (!existsSync7(join9(path, ".git"))) continue;
+          seen.add(path);
+          let mtimeMs = 0;
+          try {
+            mtimeMs = statSync(path).mtimeMs;
+          } catch {
+            mtimeMs = Date.now();
+          }
+          orphans.push({ path, repoPath, mtimeMs });
+        }
+      }
+    } catch {
+    }
+  }
+  return orphans.sort((a, b) => a.mtimeMs - b.mtimeMs);
+}
+async function cleanupOrphanWorktrees(opts) {
+  const settings = loadAppSettings();
+  const maxCount = opts?.maxCount ?? settings.advanced.worktreeMaxCount ?? 25;
+  const orphans = await findOrphanWorktrees(opts?.repoPaths);
+  const activeCount = listThreads().filter((t) => t.status !== "archived").length;
+  const budget = Math.max(0, maxCount - activeCount);
+  const sortedNewestFirst = [...orphans].sort((a, b) => b.mtimeMs - a.mtimeMs);
+  const keep = new Set(sortedNewestFirst.slice(0, budget).map((o) => o.path));
+  const removed = [];
+  const kept = [];
+  for (const orphan of orphans) {
+    if (keep.has(orphan.path)) {
+      kept.push(orphan.path);
+      continue;
+    }
+    if (opts?.dryRun) {
+      removed.push(orphan.path);
+      continue;
+    }
+    try {
+      await removeWorktree(orphan.repoPath, orphan.path);
+      removed.push(orphan.path);
+    } catch {
+      kept.push(orphan.path);
+    }
+  }
+  if (!opts?.dryRun) {
+    updateAdvancedSettings({
+      worktreeLastCleanupAt: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  }
+  return { removed, kept, orphans };
+}
+function shouldRunWorktreeCleanup(settings = loadAppSettings()) {
+  const intervalHours = settings.advanced.worktreeCleanupIntervalHours ?? 6;
+  const last = settings.advanced.worktreeLastCleanupAt;
+  if (!last) return true;
+  const elapsed = Date.now() - Date.parse(last);
+  return elapsed >= intervalHours * 36e5;
+}
+function worktreeCleanupSettings() {
+  const a = loadAppSettings().advanced;
+  return {
+    worktreeMaxCount: a.worktreeMaxCount,
+    worktreeCleanupIntervalHours: a.worktreeCleanupIntervalHours,
+    worktreeLastCleanupAt: a.worktreeLastCleanupAt,
+    autoCleanupOrphans: a.autoCleanupOrphans
+  };
+}
+
+// src/store/history-cleanup.ts
+function stripArchivedTranscript(thread) {
+  writeThread(
+    {
+      ...thread,
+      attachments: [],
+      pendingTurnAttachments: [],
+      queueAttachments: [],
+      compactedMessages: void 0,
+      messages: [historyRetentionStubMessage(thread)]
+    },
+    { touch: false }
+  );
+}
+function cleanupArchivedHistory(opts = {}) {
+  const settings = loadAppSettings();
+  if (!opts.force && opts.purgeOlderThanDays == null && !autoCleanupHistoryEnabled(settings)) {
+    return { stripped: [], purged: [] };
+  }
+  const archived = listThreads({ includeArchived: true }).filter((t) => t.status === "archived");
+  const nowMs = opts.nowMs ?? Date.now();
+  const plan = opts.purgeOlderThanDays != null ? { stripIds: [], purgeIds: planHistoryAgePurge(archived, opts.purgeOlderThanDays, nowMs) } : planHistoryRetention(archived, {
+    maxCount: opts.maxCount ?? historyMaxCount(settings),
+    maxDays: opts.maxDays ?? historyMaxDays(settings),
+    nowMs
+  });
+  const stripped = [];
+  const purged = [];
+  if (opts.dryRun) {
+    return { stripped: plan.stripIds, purged: plan.purgeIds };
+  }
+  for (const id of plan.stripIds) {
+    const thread = readThread(id);
+    if (!thread || thread.status !== "archived") continue;
+    try {
+      stripArchivedTranscript(thread);
+      stripped.push(id);
+    } catch {
+    }
+  }
+  for (const id of plan.purgeIds) {
+    const thread = readThread(id);
+    if (!thread || thread.status !== "archived") continue;
+    try {
+      deleteThreadRecord(id);
+      purged.push(id);
+    } catch {
+    }
+  }
+  if (stripped.length > 0 || purged.length > 0) {
+    updateAdvancedSettings({
+      historyLastCleanupAt: new Date(nowMs).toISOString()
+    });
+  }
+  return { stripped, purged };
+}
+function shouldRunHistoryCleanup(settings = loadAppSettings()) {
+  if (!autoCleanupHistoryEnabled(settings)) return false;
+  const intervalHours = settings.advanced.historyCleanupIntervalHours ?? HISTORY_CLEANUP_INTERVAL_HOURS_DEFAULT;
+  const last = settings.advanced.historyLastCleanupAt;
+  if (!last) return true;
+  const elapsed = Date.now() - Date.parse(last);
+  return Number.isFinite(elapsed) && elapsed >= intervalHours * 36e5;
+}
+
+// src/git/apply-into-main.ts
+import { execa as execa3 } from "execa";
+async function applyThreadIntoMain(thread, opts) {
+  const method = opts?.method ?? "merge";
+  const target = opts?.targetBranch?.trim() || await resolveDefaultBranch(thread.repoPath);
+  const status = await execa3("git", ["status", "--porcelain"], {
+    cwd: thread.repoPath,
+    reject: false
+  });
+  if (status.stdout.trim()) {
+    throw new Error(
+      `Main checkout is dirty \u2014 commit or stash before apply-into-main (${thread.repoPath})`
+    );
+  }
+  const checkout = await execa3("git", ["checkout", target], {
+    cwd: thread.repoPath,
+    reject: false
+  });
+  if (checkout.exitCode !== 0) {
+    throw new Error(
+      `Failed to checkout ${target}: ${checkout.stderr.trim() || checkout.stdout.trim()}`
+    );
+  }
+  if (method === "cherry-pick") {
+    const log = await execa3(
+      "git",
+      ["log", "--reverse", "--format=%H", `${target}..${thread.branchName}`],
+      { cwd: thread.repoPath, reject: false }
+    );
+    const shas = log.stdout.split("\n").map((s) => s.trim()).filter(Boolean);
+    if (!shas.length) {
+      return {
+        applied: false,
+        method,
+        targetBranch: target,
+        message: `No commits on ${thread.branchName} not already in ${target}`
+      };
+    }
+    for (const sha of shas) {
+      const cp = await execa3("git", ["cherry-pick", sha], {
+        cwd: thread.repoPath,
+        reject: false
+      });
+      if (cp.exitCode !== 0) {
+        await execa3("git", ["cherry-pick", "--abort"], {
+          cwd: thread.repoPath,
+          reject: false
+        });
+        throw new Error(
+          `Cherry-pick ${sha.slice(0, 8)} failed: ${cp.stderr.trim() || cp.stdout.trim()}`
+        );
+      }
+    }
+    return {
+      applied: true,
+      method,
+      targetBranch: target,
+      message: `Cherry-picked ${shas.length} commit(s) from ${thread.branchName} into ${target}`
+    };
+  }
+  const merge = await execa3(
+    "git",
+    ["merge", "--no-ff", "-m", `Apply Sideboard thread ${thread.branchName}`, thread.branchName],
+    { cwd: thread.repoPath, reject: false }
+  );
+  if (merge.exitCode !== 0) {
+    await execa3("git", ["merge", "--abort"], {
+      cwd: thread.repoPath,
+      reject: false
+    });
+    throw new Error(
+      `Merge failed: ${merge.stderr.trim() || merge.stdout.trim()}`
+    );
+  }
+  return {
+    applied: true,
+    method: "merge",
+    targetBranch: target,
+    message: `Merged ${thread.branchName} into ${target} at ${thread.repoPath}`
+  };
+}
+
+// src/git/clone-repo.ts
+import { existsSync as existsSync8 } from "fs";
+import { basename as basename2, join as join10 } from "path";
+import { execa as execa4 } from "execa";
+async function cloneRepoIntoSideboard(opts) {
+  const url = opts.url.trim();
+  if (!url) throw new Error("Clone URL is required");
+  let name = opts.name?.trim();
+  if (!name) {
+    const leaf = basename2(url.replace(/\/$/, "").replace(/\.git$/, ""));
+    name = leaf || "repo";
+  }
+  name = name.replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "repo";
+  const dest = join10(sideboardReposDir(), name);
+  if (existsSync8(dest)) {
+    const repoPath2 = await resolveRepoRoot(dest);
+    const workspace2 = await ensureWorkspace(repoPath2);
+    return { repoPath: repoPath2, workspace: workspace2 };
+  }
+  const result = await execa4("git", ["clone", url, dest], { reject: false });
+  if (result.exitCode !== 0) {
+    throw new Error(
+      `git clone failed: ${result.stderr?.trim() || result.stdout?.trim() || `exit ${result.exitCode}`}`
+    );
   }
-  return { action: "none" };
-}
-function tailProgress(logFile, maxLines = 12) {
-  if (!existsSync8(logFile)) return "(no log yet)";
-  const lines = readFileSync7(logFile, "utf8").split("\n");
-  return lines.slice(-maxLines).join("\n");
+  const repoPath = await resolveRepoRoot(dest);
+  const workspace = await ensureWorkspace(repoPath);
+  return { repoPath, workspace };
 }
-function lastProgressLine(progress) {
-  const last = progress.split("\n").map((l) => l.trim()).filter((l) => l && l !== "(no log yet)").at(-1);
-  return last ? last.slice(0, 72) : void 0;
+
+// src/types/thread.ts
+function isUnclaimedRunScriptRequest(req) {
+  return Boolean(req && !req.claimedAt && !req.fulfilledAt && !req.error);
 }
-function readLogLines(file) {
-  if (!existsSync8(file)) return [];
-  const lines = readFileSync7(file, "utf8").split("\n");
-  if (lines.length && lines[lines.length - 1] === "") lines.pop();
-  return lines;
+function isAdoptableRunScriptRequest(req) {
+  return Boolean(req && !req.fulfilledAt && !req.error);
 }
-function takeDelta(logFile, cursorFile) {
-  const lines = readLogLines(logFile);
-  const cursor = readIntFile(cursorFile) ?? 0;
-  const start = Math.min(Math.max(0, cursor), lines.length);
-  return { delta: capJobLogDelta(lines.slice(start).join("\n")), nextCursor: lines.length };
+
+// src/store/desktop-host.ts
+import { readFileSync as readFileSync7, unlinkSync, writeFileSync as writeFileSync6 } from "fs";
+import { join as join11 } from "path";
+function desktopHostPidPath() {
+  return join11(appDataDir(), "desktop-host.pid");
 }
-function snapshotJob(dir) {
-  const pid = readIntFile(join11(dir, "pid"));
-  const running = jobTreeAlive(pid);
-  return {
-    pid,
-    running,
-    exitCode: readIntFile(join11(dir, "exit")),
-    log: join11(dir, "log"),
-    cursor: join11(dir, "present.cursor"),
-    progress: tailProgress(join11(dir, "log"))
-  };
+function claimDesktopHost(pid = process.pid) {
+  writeFileSync6(desktopHostPidPath(), `${pid}
+`, "utf8");
 }
-function toResult(id, snap, extra) {
-  const failed = extra?.failed === true || !snap.running && snap.exitCode != null && snap.exitCode !== 0;
-  const ok = !snap.running && snap.exitCode === 0;
-  const stillRunning = snap.running && !ok;
-  const { delta, nextCursor } = takeDelta(snap.log, snap.cursor);
+function releaseDesktopHost(pid = process.pid) {
+  if (readDesktopHostPid() !== pid) return;
   try {
-    mkdirSync5(dirname4(snap.cursor), { recursive: true });
-    writeFileSync6(snap.cursor, `${nextCursor}
-`);
+    unlinkSync(desktopHostPidPath());
   } catch {
   }
-  const status = ok ? "ok" : failed && !stillRunning ? "failed" : stillRunning ? "running" : "idle";
-  const progress = extra?.progress ?? snap.progress;
-  return {
-    stillRunning,
-    ok,
-    failed: Boolean(failed && !stillRunning && !ok),
-    status,
-    id,
-    pid: snap.pid,
-    exitCode: snap.exitCode ?? void 0,
-    phase: lastProgressLine(progress),
-    delta,
-    progress,
-    hint: stillRunning ? MCP_WAIT_JOB_STILL_RUNNING_HINT : void 0
-  };
-}
-async function sleepMs(ms) {
-  await new Promise((resolve2) => setTimeout(resolve2, ms));
-}
-async function waitForDetachedJob(cwd, id, opts) {
-  const jobId = sanitizeDetachedJobId(id);
-  const root = cwd.trim() || process.cwd();
-  const dir = resolveJobDir(root, jobId);
-  const timeoutMs = mcpWaitForJobTimeoutMs(opts?.timeoutMs);
-  const sleep = opts?.sleep ?? sleepMs;
-  if (!existsSync8(dir)) {
-    return {
-      stillRunning: false,
-      ok: false,
-      failed: true,
-      status: "failed",
-      id: jobId,
-      delta: "",
-      progress: "No detached job. Start one first.",
-      hint: "Start with detached-job.cjs start <id> -- <command>, then call wait_for_job again."
-    };
-  }
-  const deadline = Date.now() + timeoutMs;
-  let snap = snapshotJob(dir);
-  if (snap.exitCode === 0 && !snap.running) return toResult(jobId, snap);
-  if (!snap.running && snap.pid == null && snap.progress === "(no log yet)") {
-    return toResult(jobId, snap, {
-      failed: true,
-      progress: "No detached job. Start one first."
-    });
-  }
-  while (Date.now() < deadline) {
-    snap = snapshotJob(dir);
-    if (snap.exitCode === 0 && !snap.running) return toResult(jobId, snap);
-    if (!snap.running) return toResult(jobId, snap, { failed: true });
-    await sleep(Math.min(2e3, Math.max(50, deadline - Date.now())));
-  }
-  snap = snapshotJob(dir);
-  return toResult(jobId, snap);
 }
-function killProcessTree(pid, signal) {
-  if (!Number.isInteger(pid) || pid <= 0) return;
-  if (process.platform !== "win32") {
-    try {
-      process.kill(-pid, signal);
-      return;
-    } catch {
-    }
-  }
+function readDesktopHostPid() {
   try {
-    process.kill(pid, signal);
+    const pid = Number.parseInt(readFileSync7(desktopHostPidPath(), "utf8").trim(), 10);
+    if (!Number.isFinite(pid) || pid <= 0) return null;
+    return pid;
   } catch {
+    return null;
   }
 }
-function appendJobLog(logFile, line) {
+function pidAlive(pid) {
   try {
-    mkdirSync5(dirname4(logFile), { recursive: true });
-    const body = line.endsWith("\n") ? line : `${line}
-`;
-    appendFileSync2(logFile, body);
+    process.kill(pid, 0);
+    return true;
   } catch {
+    return false;
   }
 }
-async function stopDetachedJob(cwd, id, opts) {
-  const jobId = sanitizeDetachedJobId(id);
-  const root = cwd.trim() || process.cwd();
-  const dir = resolveJobDir(root, jobId);
-  const sleep = opts?.sleep ?? sleepMs;
-  const why = opts?.reason?.trim() ?? "";
-  if (!existsSync8(dir)) {
-    return {
-      stillRunning: false,
-      ok: false,
-      failed: true,
-      status: "failed",
-      id: jobId,
-      delta: "",
-      progress: "No detached job. Start one first.",
-      hint: "Start with detached-job.cjs start <id> -- <command>, then wait_for_job or stop_job.",
-      stopped: false,
-      reason: "not-found"
-    };
-  }
-  let snap = snapshotJob(dir);
-  if (!snap.running) {
-    const result2 = toResult(jobId, snap);
-    return {
-      ...result2,
-      stopped: false,
-      reason: "not-running",
-      hint: "That job is already finished. Read the log; do not wait again unless you start a new command."
-    };
-  }
-  appendJobLog(snap.log, `$ stop${why ? `: ${why}` : ""}`);
-  const targetPid = snap.pid;
-  if (targetPid != null) killProcessTree(targetPid, "SIGTERM");
-  const graceMs = Number.isFinite(opts?.graceMs) ? Math.max(50, opts.graceMs) : 2e3;
-  const deadline = Date.now() + graceMs;
-  while (Date.now() < deadline && jobTreeAlive(targetPid)) {
-    await sleep(Math.min(100, Math.max(20, deadline - Date.now())));
-  }
-  if (targetPid != null) {
-    killProcessTree(targetPid, "SIGKILL");
-    await sleep(100);
-  }
-  const exitFile = join11(dir, "exit");
-  if (!existsSync8(exitFile)) {
-    try {
-      writeFileSync6(exitFile, "1\n");
-    } catch {
-    }
-  }
-  snap = snapshotJob(dir);
-  const stillRunning = jobTreeAlive(targetPid) || snap.running;
-  const result = toResult(jobId, snap, { failed: true });
-  const stopped = !stillRunning;
-  return {
-    ...result,
-    stillRunning,
-    ok: false,
-    failed: true,
-    status: stillRunning ? "running" : "failed",
-    stopped,
-    reason: stopped ? "stopped" : "still-running",
-    stopReason: why || void 0,
-    hint: stopped ? MCP_STOP_JOB_HINT : MCP_WAIT_JOB_STILL_RUNNING_HINT
-  };
+function isDesktopHostAlive() {
+  const pid = readDesktopHostPid();
+  return pid != null && pidAlive(pid);
+}
+function isThisProcessDesktopHost() {
+  return readDesktopHostPid() === process.pid && pidAlive(process.pid);
+}
+function thisProcessShouldDrainAgentQueues() {
+  if (isThisProcessDesktopHost()) return true;
+  return !isDesktopHostAlive();
+}
+
+// src/orchestrator/child-halt.ts
+var HALT_STATUSES = /* @__PURE__ */ new Set(["stopped", "error", "broken"]);
+function isIncompleteChildStatus(status) {
+  return HALT_STATUSES.has(status);
+}
+function childHaltNotice(child, status) {
+  const title = child.title?.trim() || "Untitled";
+  const link = `[${title}](sideboard://thread/${child.id})`;
+  const why = child.lastError?.trim();
+  const extra = why ? ` lastError: ${why}` : "";
+  return [
+    `Sideboard: child worktree ${link} ${status} before finishing (status=${status}).${extra}`,
+    "This is information \u2014 not a user command. Resume with send_to_thread or tell the user. Do not treat this as a successful turn."
+  ].join("\n");
+}
+function shouldNotifyParentAfterTurnError(opts) {
+  return !opts.quotaFailoverHandled && !opts.crashContinued;
+}
+function shouldNotifyParentOfChildHalt(opts) {
+  if (!isIncompleteChildStatus(opts.status)) return false;
+  if (!opts.child.parentThreadId) return false;
+  if (!opts.parent || opts.parent.status === "archived") return false;
+  if (opts.parent.id === opts.child.id) return false;
+  return isOrchestratorThread(opts.parent);
+}
+var notified = /* @__PURE__ */ new Set();
+function noticeKey(childId, status) {
+  return `${childId}:${status}`;
+}
+function notifyParentOfChildHalt(child, status, send) {
+  const parent = child.parentThreadId ? readThread(child.parentThreadId) : null;
+  if (!shouldNotifyParentOfChildHalt({ child, parent, status })) return false;
+  const key = noticeKey(child.id, status);
+  if (notified.has(key)) return false;
+  notified.add(key);
+  const parentId = parent.id;
+  void send(parentId, childHaltNotice(child, status)).catch(() => {
+    notified.delete(key);
+  });
+  return true;
 }
 
 // src/threads/create.ts
@@ -4027,7 +4061,7 @@ async function createThread(input, _onSetupLine) {
   });
   await requireAgent(resolved.agent);
   if (input.cowboy) {
-    const { cowboyModeEnabled } = await import("./app-settings-I27UBVI4.js");
+    const { cowboyModeEnabled } = await import("./app-settings-VOPXJMGV.js");
     if (!cowboyModeEnabled()) {
       throw new Error(
         "Cowboy mode is off. Enable it in Settings \u2192 Advanced."
@@ -4085,7 +4119,7 @@ async function createThread(input, _onSetupLine) {
   let sourceIsFork = false;
   if (!input.cowboy && sourceType === "branch" && (!sourceRef || sourceRef === "HEAD" || sourceRef === "default")) {
     if (isAbleTimeConnected() && getIssueSource() === "abletime") {
-      const { ensureAbleTimeTask, issueAttachmentForAbleTimeTask } = await import("./abletime-VSV6AUBV.js");
+      const { ensureAbleTimeTask, issueAttachmentForAbleTimeTask } = await import("./abletime-CWIJ7INC.js");
       const task = await ensureAbleTimeTask({
         title: title?.trim() || "Untitled work",
         description: input.prompt?.trim() || void 0
@@ -4187,7 +4221,7 @@ async function createThread(input, _onSetupLine) {
   return readThread(thread.id) ?? thread;
 }
 async function listLinearIssues(agent, repoPath) {
-  const { getAdapter: getAdapter2 } = await import("./agents-CDQCQVWU.js");
+  const { getAdapter: getAdapter2 } = await import("./agents-Q23R4WOR.js");
   await requireAgent(agent, { requireLinear: true });
   const adapter = getAdapter2(agent);
   if (!adapter.listLinearIssues) {
@@ -4660,7 +4694,7 @@ async function adoptThread(input) {
     messages: input.messages ?? []
   });
   writeThread(thread);
-  const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-JX5R4V24.js");
+  const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-CFI7XVAE.js");
   await ensureWorkspace2(repoPath);
   const { ensureWorktreeSideboardIgnored: ensureWorktreeSideboardIgnored2 } = await import("./worktree-exclude-RXZPTCNH.js");
   await ensureWorktreeSideboardIgnored2(input.worktreePath);
@@ -6650,7 +6684,7 @@ function formatWorktreeDirective(thread, opts) {
     const slug = opts?.githubSlug ?? "<origin-owner/name>";
     const resolve2 = opts?.githubSlug ? "" : " Resolve `<origin-owner/name>` with `git remote get-url origin` in this worktree.";
     lines.push(
-      `- Prefer a draft PR first: \`gh pr create --draft -R ${slug}\` (update via \`gh pr edit -R ${slug}\`). Always pass \`-R\` \u2014 bare \`gh pr create\` may target upstream on dual-remote checkouts.${resolve2} Mark ready for review only when asked. If GitHub rejects the body as too long, retry with a short \`--body-file\` \u2014 do not paste a changelog or diff into \`--body\`.`
+      `- Prefer a draft PR first: \`gh pr create --draft --assignee @me -R ${slug}\` (update via \`gh pr edit -R ${slug}\`). Always pass \`-R\` \u2014 bare \`gh pr create\` may target upstream on dual-remote checkouts.${resolve2} Assign to the GitHub-connected user (\`--assignee @me\`) unless the user named someone else. Mark ready for review only when asked. If GitHub rejects the body as too long, retry with a short \`--body-file\` \u2014 do not paste a changelog or diff into \`--body\`.`
     );
   }
   lines.push(
@@ -7372,7 +7406,7 @@ function formatScheduledPrompt(name, prompt) {
 ${prompt}`;
 }
 async function defaultDeps() {
-  const { getOrchestrator: getOrchestrator2, startOrchestration: startOrchestration2 } = await import("./orchestrator-VYNPNHY4.js");
+  const { getOrchestrator: getOrchestrator2, startOrchestration: startOrchestration2 } = await import("./orchestrator-ABF6QFE6.js");
   const orch = getOrchestrator2();
   return {
     findThread: (id) => findThreadByRef(id),
@@ -7697,7 +7731,7 @@ var Orchestrator = class {
           orphans: orphans.map((o) => ({ path: o.path, repoPath: o.repoPath }))
         });
       }
-      const { autoCleanupOrphansEnabled } = await import("./app-settings-I27UBVI4.js");
+      const { autoCleanupOrphansEnabled } = await import("./app-settings-VOPXJMGV.js");
       if (autoCleanupOrphansEnabled() && shouldRunWorktreeCleanup() && orphans.length > 0) {
         await cleanupOrphanWorktrees({ repoPaths });
       }
@@ -8044,7 +8078,7 @@ var Orchestrator = class {
     }
     await setup;
     if (skipSetup) return;
-    const { autoRunAfterSetupEnabled } = await import("./app-settings-I27UBVI4.js");
+    const { autoRunAfterSetupEnabled } = await import("./app-settings-VOPXJMGV.js");
     if (autoRunAfterSetupEnabled()) {
       try {
         await this.startDev(threadId);
@@ -8295,7 +8329,8 @@ var Orchestrator = class {
         if (compact.didCompact) {
           thread = updateThread(threadId, {
             messages: compact.thread.messages,
-            sessionId: compact.thread.sessionId
+            sessionId: compact.thread.sessionId,
+            compactedMessages: compact.thread.compactedMessages
           });
           this.emit({
             type: "context_compacted",
@@ -8309,9 +8344,6 @@ var Orchestrator = class {
         this.emit({ type: "error", threadId, message: `context compact failed: ${message}` });
         thread = this.requireThread(threadId);
       }
-      if (this.stoppedTurns.has(threadId)) {
-        return;
-      }
       const promptText = typeof prompt === "string" ? prompt : "";
       const autoContinue = isJobContinuePrompt(promptText) || promptText.startsWith("The previous agent process ended before it finished.");
       const parked = takePendingTurnAttachments(thread);
@@ -8328,6 +8360,14 @@ var Orchestrator = class {
         agent: thread.agent,
         orch: isOrchestratorThread(thread)
       });
+      if (this.stoppedTurns.has(threadId)) {
+        const stopped = writeLiveStatus(threadId, "stopped");
+        if (stopped?.status === "stopped") {
+          this.emit({ type: "status_changed", threadId, status: "stopped" });
+        }
+        this.emit({ type: "turn_finished", threadId, exitCode: 1 });
+        return;
+      }
       thread = this.requireThread(threadId);
       const gitPrompt = expandCanonicalGitRequest(promptText);
       const { agentPrompt: expandedPrompt } = expandComposerPrompt(
@@ -8386,7 +8426,7 @@ var Orchestrator = class {
       ].filter(Boolean).join("\n\n") || void 0;
       const prGateDirective = thread.agent !== "brightsy" && !isOrchestratorThread(thread) && mentionsPrGoal(promptText) ? formatPrGateDirective() : null;
       const agentPrompt = [
-        thread.planMode ? PLAN_MODE_INSTRUCTION : null,
+        planModeTurnInstruction(thread.planMode),
         orchestrationReminder,
         prGateDirective,
         injectedNoticeContext,
@@ -8408,7 +8448,7 @@ var Orchestrator = class {
       }
       const isBrightsy = fresh.agent === "brightsy";
       const isOrchestration = isOrchestratorThread(fresh);
-      const { autoRenameBranchEnabled, getGithubGitAuthMode, gitBranchPrefixSetting } = await import("./app-settings-I27UBVI4.js");
+      const { autoRenameBranchEnabled, getGithubGitAuthMode, gitBranchPrefixSetting } = await import("./app-settings-VOPXJMGV.js");
       const gitAuthMode = getGithubGitAuthMode();
       const worktreeDirective = isBrightsy || isOrchestration ? null : formatWorktreeDirective(fresh, {
         githubSlug: await withTimeout(
@@ -9699,7 +9739,7 @@ var Orchestrator = class {
     if (!titled.userSetTitle && meta.title && titled.title !== meta.title) {
       updateThread(thread.id, { title: meta.title });
     }
-    const { autoArchiveOnMergeEnabled } = await import("./app-settings-I27UBVI4.js");
+    const { autoArchiveOnMergeEnabled } = await import("./app-settings-VOPXJMGV.js");
     const latest = this.requireThread(thread.id);
     if (!shouldAutoArchiveOnPrMerge({
       previousPrState: prevState || null,
@@ -9981,7 +10021,7 @@ var Orchestrator = class {
     this.enforceHistoryRetention();
     if (thread.repoPath && !isGlobalRepoPath(thread.repoPath)) {
       try {
-        const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-JX5R4V24.js");
+        const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-CFI7XVAE.js");
         await ensureWorkspace2(thread.repoPath);
       } catch {
       }
@@ -10008,7 +10048,7 @@ var Orchestrator = class {
           await runArchiveScript(thread.repoPath, thread.worktreePath);
         } catch {
         }
-        const { deleteBranchOnPurgeEnabled } = await import("./app-settings-I27UBVI4.js");
+        const { deleteBranchOnPurgeEnabled } = await import("./app-settings-VOPXJMGV.js");
         const deleteBranch = opts?.deleteBranch ?? deleteBranchOnPurgeEnabled();
         await removeWorktree(thread.repoPath, thread.worktreePath, {
           deleteBranch: deleteBranch ? thread.branchName : void 0
@@ -10035,7 +10075,7 @@ var Orchestrator = class {
           `Cowboy checkout missing: ${thread.worktreePath}. Re-add the project folder, then restore.`
         );
       }
-      const { createThreadWorktree: createThreadWorktree2 } = await import("./worktree-AGVPKDBH.js");
+      const { createThreadWorktree: createThreadWorktree2 } = await import("./worktree-4UAOZUJ4.js");
       const slug = thread.worktreePath.split("/").pop();
       const dest = thread.worktreePath;
       await withRepoGitLock(thread.repoPath, async () => {
@@ -10145,7 +10185,7 @@ async function startOrchestration(opts) {
     sourceRef: "default",
     ...createOpts
   }).catch(async () => {
-    const { resolveDefaultBranch: resolveDefaultBranch2, resolveRepoRoot: resolveRepoRoot2 } = await import("./worktree-AGVPKDBH.js");
+    const { resolveDefaultBranch: resolveDefaultBranch2, resolveRepoRoot: resolveRepoRoot2 } = await import("./worktree-4UAOZUJ4.js");
     const repo = await resolveRepoRoot2(repoPath);
     const def = await resolveDefaultBranch2(repo);
     return orch.createThread({
@@ -10155,7 +10195,7 @@ async function startOrchestration(opts) {
       repoPath: repo
     });
   });
-  const { updateThread: upd } = await import("./thread-store-AYPBEZT5.js");
+  const { updateThread: upd } = await import("./thread-store-SCV2IZYS.js");
   const updated = upd(thread.id, {
     sourceType: "orchestration",
     sourceRef: goal
@@ -10260,6 +10300,9 @@ export {
   findLastBrightsyContextSummary,
   messagesSinceLastBrightsyContextSummary,
   buildBrightsySessionSeed,
+  compactArchiveProse,
+  messagesForCompactArchive,
+  appendCompactedMessages,
   applyCompaction,
   lastRequestOccupancy,
   shouldResetSessionForOccupancy,
@@ -10295,6 +10338,11 @@ export {
   worktreeRunPortsPath,
   loadWorktreeRunPorts,
   saveWorktreeRunPorts,
+  mcpWaitForTurnTimeoutMs,
+  mcpWaitTaskHint,
+  mcpWaitForJobTimeoutMs,
+  waitForDetachedJob,
+  stopDetachedJob,
   PORT_RANGE_SIZE,
   readWorktreeInclude,
   resolveFilesToCopy,
@@ -10331,11 +10379,6 @@ export {
   shouldRunHistoryCleanup,
   applyThreadIntoMain,
   cloneRepoIntoSideboard,
-  mcpWaitForTurnTimeoutMs,
-  mcpWaitTaskHint,
-  mcpWaitForJobTimeoutMs,
-  waitForDetachedJob,
-  stopDetachedJob,
   detectAgents,
   requireAgent,
   createThread,