@sideboard-ai/core 0.1.264 → 0.1.267

package/dist/chunk-4ECDIKAS.js

@@ -0,0 +1,2273 @@
+#!/usr/bin/env node
+
+import {
+  clipToolResultForStore,
+  compactSummaryPart,
+  isInternalAgentStatusText,
+  lastAssistantMessageText
+} from "./chunk-UKSJO36E.js";
+import {
+  isCloudCoordinatorThread,
+  isGlobalThread,
+  isOrchestratorThread,
+  isSlackCoordinatorThread
+} from "./chunk-GZXKUUJO.js";
+import {
+  allocateTeamName,
+  mergeAgentGitAuthEnv,
+  normalizeWorktreePath,
+  resolveAgentGitAuthEnv,
+  takenSlugsFromThread,
+  worktreeNameFromPath
+} from "./chunk-NWE3NOWQ.js";
+import {
+  ATTACHMENTS_DIR,
+  DETACHED_JOBS_DIR,
+  LEGACY_ATTACHMENTS_DIR,
+  LEGACY_DETACHED_JOBS_DIR
+} from "./chunk-N2WW62LF.js";
+import {
+  ensureWorktreeSideboardIgnored
+} from "./chunk-DD67JWTN.js";
+import {
+  ensureAgentPath,
+  run
+} from "./chunk-2UG25RMK.js";
+import {
+  assertOrchestratorCapableAgent,
+  contextTokens
+} from "./chunk-OIENQEGG.js";
+import {
+  stripNestedElectronEnv
+} from "./chunk-WWUABK6B.js";
+import {
+  createEmptyThread,
+  findThreadByRef,
+  listThreads,
+  updateThread,
+  writeThread
+} from "./chunk-JANCPF7Z.js";
+import {
+  findConventionSetup,
+  loadRepoSettings,
+  loadWorkspaceSettings,
+  runCursorWorktreeSetup,
+  workspaceSettingsSourceLabel
+} from "./chunk-H5XL4KUS.js";
+
+// src/hook/conductor.ts
+import {
+  copyFileSync,
+  existsSync as existsSync4,
+  mkdirSync as mkdirSync5,
+  readdirSync as readdirSync2,
+  readFileSync as readFileSync4,
+  realpathSync
+} from "fs";
+import { execFileSync } from "child_process";
+import { basename, dirname as dirname4, join as join5, resolve, sep } from "path";
+import { execa } from "execa";
+import { createInterface } from "readline";
+
+// src/hook/worktree-pkg-cache.ts
+import { existsSync, mkdirSync } from "fs";
+import { join } from "path";
+var WORKTREE_PKG_CACHE_REL = ".context/.sideboard/pkg-cache";
+function worktreePkgCacheRoot(worktreePath) {
+  return join(worktreePath, WORKTREE_PKG_CACHE_REL);
+}
+function worktreePkgCacheEnv(worktreePath) {
+  const root = worktreePkgCacheRoot(worktreePath);
+  const store = join(root, "pnpm-store");
+  const pnpmCache = join(root, "pnpm");
+  const npmCache = join(root, "npm");
+  const nodeGyp = join(root, "node-gyp");
+  const electron = join(root, "electron");
+  return {
+    npm_config_store_dir: store,
+    PNPM_STORE_DIR: store,
+    npm_config_cache_dir: pnpmCache,
+    npm_config_cache: npmCache,
+    npm_config_devdir: nodeGyp,
+    // @electron/get — do not set ELECTRON_CACHE (stripNestedElectronEnv).
+    electron_config_cache: electron
+  };
+}
+function isSet(value) {
+  return value != null && value.trim() !== "";
+}
+function fillGroup(env, keys, values) {
+  if (keys.some((key) => isSet(env[key]))) return;
+  for (const key of keys) {
+    const value = values[key];
+    if (value) env[key] = value;
+  }
+}
+function ensureWorktreePkgCacheDirs(worktreePath) {
+  if (!existsSync(worktreePath)) return;
+  mkdirSync(worktreePkgCacheRoot(worktreePath), { recursive: true });
+}
+function applyWorktreePkgCacheEnv(env, worktreePath) {
+  const cwd = worktreePath.trim();
+  if (!cwd) return;
+  const next = worktreePkgCacheEnv(cwd);
+  fillGroup(env, ["npm_config_store_dir", "PNPM_STORE_DIR"], next);
+  fillGroup(env, ["npm_config_cache_dir"], next);
+  fillGroup(env, ["npm_config_cache"], next);
+  fillGroup(env, ["npm_config_devdir"], next);
+  fillGroup(env, ["electron_config_cache"], next);
+  ensureWorktreePkgCacheDirs(cwd);
+}
+
+// src/review/request-review.ts
+import { randomUUID as randomUUID2 } from "crypto";
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync, writeFileSync } from "fs";
+import { dirname, join as join2 } from "path";
+
+// src/threads/chat-tabs.ts
+import { randomUUID } from "crypto";
+
+// src/composer/context-estimate.ts
+var CHARS_PER_CONTEXT_TOKEN = 4;
+function estimateMessageChars(message) {
+  let n = message.text.length + 16;
+  for (const part of message.parts ?? []) {
+    n += estimatePartChars(part);
+  }
+  return n;
+}
+function estimatePartChars(part) {
+  switch (part.type) {
+    case "text":
+    case "thinking":
+      return part.text.length;
+    case "tool": {
+      const input = part.input ? JSON.stringify(part.input) : "";
+      return part.name.length + (part.description?.length ?? 0) + (part.detail?.length ?? 0) + (part.result?.length ?? 0) + input.length + 32;
+    }
+    default:
+      return 0;
+  }
+}
+function estimateThreadChars(messages) {
+  return messages.reduce((sum, m) => sum + estimateMessageChars(m), 0);
+}
+function estimateOccupancyTokens(messages) {
+  return Math.ceil(estimateThreadChars(messages) / CHARS_PER_CONTEXT_TOKEN);
+}
+function applyForwardOccupancy(messages) {
+  const tokens = estimateOccupancyTokens(messages);
+  if (tokens <= 0) return messages;
+  for (let i = messages.length - 1; i >= 0; i--) {
+    const m = messages[i];
+    if (m?.role !== "agent" || !m.usage) continue;
+    const current = contextTokens(m.usage);
+    if (tokens >= current) return messages;
+    const next = messages.slice();
+    next[i] = { ...m, usage: { ...m.usage, lastRequestTokens: tokens } };
+    return next;
+  }
+  return messages;
+}
+
+// src/composer/summarize.ts
+var MAX_TRANSCRIPT_CHARS = 12e4;
+var MAX_SUMMARY_CHARS = 6e3;
+var CLAUDE_SUMMARY_TIMEOUT_MS = 2e4;
+async function summarizeConversation(transcript, opts) {
+  const clipped = transcript.length > MAX_TRANSCRIPT_CHARS ? `${transcript.slice(0, MAX_TRANSCRIPT_CHARS)}
+
+[\u2026truncated\u2026]` : transcript;
+  const claudeSummary = await tryClaudeSummary(clipped, opts);
+  if (claudeSummary) {
+    return { summary: clipSummary(claudeSummary), method: "claude" };
+  }
+  return { summary: clipSummary(extractiveSummary(clipped)), method: "extractive" };
+}
+async function tryClaudeSummary(transcript, opts) {
+  ensureAgentPath();
+  const prompt = [
+    "Summarize this coding-agent conversation for continuity in a fresh session.",
+    "Use concise markdown bullets covering:",
+    "- Goal / request",
+    "- Key decisions and constraints",
+    "- Files / areas touched",
+    "- Current state and open tasks",
+    "- Anything the next turn must remember",
+    "Do not invent details. No preamble.",
+    "",
+    "Transcript:",
+    transcript
+  ].join("\n");
+  try {
+    const { stdout, exitCode } = await run(
+      "claude",
+      [
+        "-p",
+        prompt,
+        "--output-format",
+        "text",
+        "--permission-mode",
+        "bypassPermissions",
+        "--model",
+        "haiku"
+      ],
+      {
+        cwd: opts?.cwd,
+        reject: false,
+        timeoutMs: opts?.timeoutMs ?? CLAUDE_SUMMARY_TIMEOUT_MS
+      }
+    );
+    if (exitCode !== 0) return null;
+    const text = stdout.trim();
+    if (text.length < 40) return null;
+    return text;
+  } catch {
+    return null;
+  }
+}
+function extractiveSummary(transcript) {
+  const lines = transcript.split("\n").map((l) => l.trim()).filter(Boolean);
+  const users = [];
+  const tools = [];
+  const agents = [];
+  let mode = "none";
+  for (const line of lines) {
+    if (line.startsWith("### User")) {
+      mode = "user";
+      continue;
+    }
+    if (line.startsWith("### Agent") || line.startsWith("## Prior")) {
+      mode = "agent";
+      continue;
+    }
+    if (line.startsWith("- ") && line.includes(":")) {
+      tools.push(line.replace(/^- /, ""));
+      continue;
+    }
+    if (mode === "user" && users.length < 8) {
+      users.push(line.slice(0, 240));
+    } else if (mode === "agent" && agents.length < 6) {
+      agents.push(line.slice(0, 240));
+    }
+  }
+  const uniqueTools = [...new Set(tools)].slice(0, 20);
+  const parts = [
+    "## Compacted context (extractive)",
+    "",
+    "### User goals",
+    ...users.length ? users.map((u) => `- ${u}`) : ["- (none captured)"],
+    "",
+    "### Recent agent notes",
+    ...agents.length ? agents.map((a) => `- ${a}`) : ["- (none captured)"]
+  ];
+  if (uniqueTools.length) {
+    parts.push("", "### Tools / files", ...uniqueTools.map((t) => `- ${t}`));
+  }
+  parts.push(
+    "",
+    "_Automatic extractive summary \u2014 Claude summarizer was unavailable._"
+  );
+  return parts.join("\n");
+}
+function clipSummary(text) {
+  if (text.length <= MAX_SUMMARY_CHARS) return text;
+  return `${text.slice(0, MAX_SUMMARY_CHARS)}
+
+[\u2026summary truncated\u2026]`;
+}
+
+// src/composer/context-compact.ts
+var CONTEXT_COMPACT_CHARS = 4e5;
+var CONTEXT_KEEP_RECENT_CHARS = 24e3;
+var CONTEXT_KEEP_RECENT_MESSAGES = 12;
+var CONTEXT_MIN_MESSAGES = 10;
+var SESSION_RESET_OCCUPANCY_TOKENS = 75e4;
+function shouldCompactContext(messages, thresholds = {}) {
+  const maxChars = thresholds.maxChars ?? CONTEXT_COMPACT_CHARS;
+  const minMessages = thresholds.minMessages ?? CONTEXT_MIN_MESSAGES;
+  if (messages.length < minMessages) return false;
+  return estimateThreadChars(messages) >= maxChars;
+}
+function splitForCompaction(messages, thresholds = {}) {
+  const keepChars = thresholds.keepRecentChars ?? CONTEXT_KEEP_RECENT_CHARS;
+  const keepCount = thresholds.keepRecentMessages ?? CONTEXT_KEEP_RECENT_MESSAGES;
+  if (messages.length === 0) return { older: [], recent: [] };
+  let recentChars = 0;
+  let cut = messages.length;
+  for (let i = messages.length - 1; i >= 0; i--) {
+    const next = recentChars + estimateMessageChars(messages[i]);
+    const kept = messages.length - i;
+    if (kept >= keepCount && next > keepChars) break;
+    recentChars = next;
+    cut = i;
+  }
+  const minRecent = Math.min(keepCount, messages.length);
+  cut = Math.min(cut, messages.length - minRecent);
+  if (cut <= 0) return { older: [], recent: messages };
+  return {
+    older: messages.slice(0, cut),
+    recent: messages.slice(cut)
+  };
+}
+function formatToolPart(t, detail) {
+  if (detail === "summary") {
+    const label = t.description || t.detail || t.name;
+    const path = t.filePath ? ` (${t.filePath})` : "";
+    return `- ${t.name}: ${label}${path}`;
+  }
+  const lines = [`#### Tool: ${t.name}`, `Status: ${t.status}`];
+  if (t.description) lines.push(`Description: ${t.description}`);
+  if (t.filePath) lines.push(`Path: ${t.filePath}`);
+  if (t.input && Object.keys(t.input).length > 0) {
+    lines.push("Input:");
+    lines.push("```json");
+    lines.push(clipToolResultForStore(JSON.stringify(t.input, null, 2)) ?? "");
+    lines.push("```");
+  } else if (t.detail) {
+    lines.push(`Detail: ${t.detail}`);
+  }
+  if (t.result != null && t.result !== "") {
+    lines.push("Result:");
+    lines.push("```");
+    lines.push(t.result);
+    lines.push("```");
+  }
+  return lines.join("\n");
+}
+function formatMessagesAsTranscript(messages, opts) {
+  const tools = opts?.tools ?? "full";
+  const thinking = opts?.thinking ?? true;
+  return messages.map((m) => formatMessageBlock(m, { tools, thinking })).join("\n\n");
+}
+function formatMessageBlock(m, opts) {
+  if (m.role === "summary") return `## Prior summary
+${m.text}`;
+  if (m.role === "user") return `### User
+${m.text}`;
+  const bits = [];
+  if (m.text?.trim()) {
+    bits.push(`### Agent
+${m.text}`);
+  } else {
+    bits.push("### Agent");
+  }
+  if (opts.thinking) {
+    for (const th of m.parts ?? []) {
+      if (th.type !== "thinking" || !th.text.trim()) continue;
+      bits.push("Thinking:");
+      bits.push(th.text);
+    }
+  }
+  const toolParts = (m.parts ?? []).filter(
+    (p) => p.type === "tool"
+  );
+  if (opts.tools !== "none" && toolParts.length > 0) {
+    if (opts.tools === "summary") bits.push("Tools:");
+    for (const t of toolParts) {
+      bits.push(formatToolPart(t, opts.tools));
+    }
+  }
+  return bits.join("\n");
+}
+var SEED_MAX_CHARS = 6e4;
+var SEED_FULL_TOOL_MESSAGES = 6;
+function budgetSeedBlocks(messages, blocks, maxChars) {
+  const keep = new Array(blocks.length).fill(false);
+  let used = 0;
+  for (let i = 0; i < blocks.length; i++) {
+    if (messages[i].role === "summary") {
+      keep[i] = true;
+      used += blocks[i].length + 2;
+    }
+  }
+  for (let i = blocks.length - 1; i >= 0; i--) {
+    if (keep[i]) continue;
+    const next = used + blocks[i].length + 2;
+    if (next > maxChars && used > 0) continue;
+    keep[i] = true;
+    used = next;
+  }
+  const dropped = keep.filter((k) => !k).length;
+  const marker = `_(${dropped} older message${dropped === 1 ? "" : "s"} omitted for length)_`;
+  const kept = [];
+  let markerPlaced = false;
+  for (let i = 0; i < blocks.length; i++) {
+    if (!keep[i]) continue;
+    if (dropped > 0 && !markerPlaced && messages[i].role !== "summary") {
+      kept.push(marker);
+      markerPlaced = true;
+    }
+    kept.push(blocks[i]);
+  }
+  if (dropped > 0 && !markerPlaced) kept.push(marker);
+  return kept.join("\n\n");
+}
+function buildSessionSeed(messages, opts) {
+  if (messages.length === 0) return null;
+  const tools = opts?.tools ?? "full";
+  const fullCount = opts?.fullToolMessages ?? SEED_FULL_TOOL_MESSAGES;
+  const maxChars = opts?.maxChars ?? SEED_MAX_CHARS;
+  const olderTools = tools === "none" ? "none" : "summary";
+  const fullFrom = Math.max(0, messages.length - fullCount);
+  const blocks = messages.map(
+    (m, i) => formatMessageBlock(m, {
+      tools: i >= fullFrom ? tools : olderTools,
+      thinking: false
+    })
+  );
+  const body = budgetSeedBlocks(messages, blocks, maxChars);
+  if (!body.trim()) return null;
+  return [
+    "Sideboard conversation context (restored after compaction or a new session):",
+    "",
+    body,
+    "",
+    "Continue from this context. Do not repeat the summary unless asked."
+  ].join("\n");
+}
+var BRIGHTSY_SUMMARIZE_CONTEXT_TOOL = "summarize_context";
+function extractBrightsyContextSummary(result) {
+  if (!result?.trim()) return null;
+  const trimmed = result.trim();
+  const lower = trimmed.toLowerCase();
+  if (lower.startsWith("context summarization failed") || lower.startsWith("nothing to summarize") || lower.startsWith("no messages found") || lower.startsWith("messages are required") || lower.startsWith("agent id is required")) {
+    return null;
+  }
+  try {
+    const parsed = JSON.parse(trimmed);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      if (parsed.error != null && typeof parsed.context_summary !== "string") {
+        return null;
+      }
+      if (typeof parsed.context_summary === "string" && parsed.context_summary.trim()) {
+        return parsed.context_summary.trim();
+      }
+      return null;
+    }
+  } catch {
+  }
+  if (trimmed.includes('"error"') && !trimmed.includes("context_summary")) {
+    return null;
+  }
+  return trimmed;
+}
+function findLastBrightsyContextSummary(messages) {
+  for (let i = messages.length - 1; i >= 0; i--) {
+    const message = messages[i];
+    if (message?.role !== "agent") continue;
+    for (const part of message.parts ?? []) {
+      if (part.type !== "tool" || part.name !== BRIGHTSY_SUMMARIZE_CONTEXT_TOOL) {
+        continue;
+      }
+      if (part.status === "error") continue;
+      const text = extractBrightsyContextSummary(part.result);
+      if (text) return { index: i, text };
+    }
+  }
+  return null;
+}
+function buildBrightsySessionSeed(messages, opts) {
+  const match = findLastBrightsyContextSummary(messages);
+  const tail = match ? messages.slice(match.index + 1) : messages;
+  const budget = Math.max(1e3, (opts?.maxChars ?? SEED_MAX_CHARS) - (match?.text.length ?? 0));
+  const tailBlocks = tail.map((m) => formatMessageBlock(m, { tools: "none", thinking: false }));
+  const body = budgetSeedBlocks(tail, tailBlocks, budget);
+  if (!match && !body.trim()) return null;
+  const blocks = [
+    "Sideboard conversation context (restored after compaction or a new session):",
+    ""
+  ];
+  if (match) {
+    blocks.push(`## Prior summary
+${match.text}`, "");
+  }
+  if (body.trim()) {
+    blocks.push(body, "");
+  }
+  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,
+    parts: [compactSummaryPart(text)],
+    ts: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  return [summary, ...recent];
+}
+function lastRequestOccupancy(thread) {
+  for (let i = thread.messages.length - 1; i >= 0; i--) {
+    const usage = thread.messages[i]?.usage;
+    if (usage) return contextTokens(usage);
+  }
+  return 0;
+}
+function shouldResetSessionForOccupancy(thread, occupancyTokens = SESSION_RESET_OCCUPANCY_TOKENS) {
+  return lastRequestOccupancy(thread) >= occupancyTokens;
+}
+async function maybeCompactContext(thread, thresholds = {}, summarize = summarizeConversation) {
+  if (!shouldCompactContext(thread.messages, thresholds)) {
+    return { didCompact: false, thread };
+  }
+  const { older } = splitForCompaction(thread.messages, thresholds);
+  if (older.length === 0) {
+    return { didCompact: false, thread };
+  }
+  const transcript = formatMessagesAsTranscript(older, { tools: "summary" });
+  const { summary, method } = await summarize(transcript, {
+    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);
+  }
+  const next = {
+    ...thread,
+    messages,
+    ...compactedMessages.length ? { compactedMessages } : { compactedMessages: void 0 },
+    sessionId: resetSession ? null : thread.sessionId,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  return {
+    didCompact: true,
+    thread: next,
+    summary,
+    method,
+    olderCount: older.length
+  };
+}
+
+// src/threads/worktree-runtime.ts
+function worktreeProcessPrefix(worktreePath) {
+  return `wt:${normalizeWorktreePath(worktreePath)}`;
+}
+function worktreeSetupProcessKey(worktreePath) {
+  return `${worktreeProcessPrefix(worktreePath)}:setup`;
+}
+function worktreeRunProcessKey(worktreePath, scriptName) {
+  return `${worktreeProcessPrefix(worktreePath)}:run:${scriptName}`;
+}
+function worktreeDevProcessKey(worktreePath) {
+  return `${worktreeProcessPrefix(worktreePath)}:dev`;
+}
+function isWorktreeRunProcessKey(key, worktreePath) {
+  const prefix = worktreeProcessPrefix(worktreePath);
+  return key.startsWith(`${prefix}:run:`) || key === `${prefix}:dev`;
+}
+function pickRichestSetupLog(snaps) {
+  let best;
+  for (const snap of snaps) {
+    if (!snap.output && !snap.running && snap.exitCode == null) continue;
+    if (!best) {
+      best = snap;
+      continue;
+    }
+    if (snap.running && !best.running) {
+      best = snap;
+      continue;
+    }
+    if (snap.running === best.running && snap.output.length > best.output.length) {
+      best = snap;
+    }
+  }
+  return best;
+}
+function resolveWorktreeSetupLog(shared, legacyChatLogs) {
+  if (shared.output || shared.running || shared.exitCode != null) return shared;
+  return pickRichestSetupLog(legacyChatLogs);
+}
+function mergeWorktreeActiveRuns(threads) {
+  const byName = /* @__PURE__ */ new Map();
+  let devPort = null;
+  for (const thread of threads) {
+    if (thread.devPort != null && devPort == null) devPort = thread.devPort;
+    for (const run2 of thread.activeRuns ?? []) {
+      if (!byName.has(run2.scriptName)) byName.set(run2.scriptName, run2);
+    }
+  }
+  return { activeRuns: [...byName.values()], devPort };
+}
+
+// src/threads/chat-tabs.ts
+function sameWorktreePath(a, b) {
+  return normalizeWorktreePath(a) === normalizeWorktreePath(b);
+}
+function takenTeamSlugsForChatTab(worktreePath) {
+  const key = normalizeWorktreePath(worktreePath);
+  const taken = /* @__PURE__ */ new Set();
+  const dir = worktreeNameFromPath(key);
+  if (dir) taken.add(dir.toLowerCase());
+  for (const sibling of threadsSharingWorktree(key)) {
+    for (const slug of takenSlugsFromThread(sibling)) {
+      taken.add(slug);
+    }
+  }
+  return [...taken];
+}
+function requireThread(idOrRef) {
+  const thread = findThreadByRef(idOrRef) ?? null;
+  if (!thread) throw new Error(`Thread not found: ${idOrRef}`);
+  return thread;
+}
+function worktreeBindingFrom(from) {
+  return {
+    worktreePath: normalizeWorktreePath(from.worktreePath),
+    repoPath: from.repoPath,
+    branchName: from.branchName,
+    sourceRef: from.sourceRef,
+    // Legacy pinned-repo orchestration: new tabs become normal worktree agents.
+    // Global: keep orchestration so chat tabs stay fleet orchestrators (MCP + Bash).
+    sourceType: isGlobalThread(from) ? "orchestration" : from.sourceType === "orchestration" ? "branch" : from.sourceType,
+    sourceIsFork: from.sourceIsFork,
+    parentThreadId: from.parentThreadId,
+    prUrl: from.prUrl,
+    prTitle: from.prTitle,
+    prState: from.prState,
+    prIsDraft: from.prIsDraft,
+    prAuthorLogin: from.prAuthorLogin,
+    prReviewerLogins: from.prReviewerLogins,
+    prReviewDecision: from.prReviewDecision,
+    prMergeable: from.prMergeable,
+    prMergeStateStatus: from.prMergeStateStatus,
+    prIsInMergeQueue: from.prIsInMergeQueue,
+    prLabels: from.prLabels,
+    prChecksFailed: from.prChecksFailed,
+    skipAutoArchiveOnMerge: from.skipAutoArchiveOnMerge,
+    stackId: from.stackId,
+    stackLayer: from.stackLayer,
+    cowboy: from.cowboy
+  };
+}
+function threadsSharingWorktree(worktreePath) {
+  if (!worktreePath) return [];
+  const key = normalizeWorktreePath(worktreePath);
+  return listThreads({ includeArchived: true }).filter(
+    (t) => Boolean(t.worktreePath) && sameWorktreePath(t.worktreePath, key) && t.status !== "archived"
+  ).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+}
+function formatTranscriptMarkdown(title, messages) {
+  const body = formatMessagesAsTranscript(messages, { tools: "full" });
+  return [`# Transcript: ${title}`, "", `Forked ${(/* @__PURE__ */ new Date()).toISOString()}`, "", body].join("\n");
+}
+function forkMessageSlice(from, throughIndex) {
+  const through = throughIndex === void 0 ? from.messages.length - 1 : Math.min(throughIndex, from.messages.length - 1);
+  return through >= 0 ? from.messages.slice(0, through + 1) : [];
+}
+function buildForkTranscriptAttachment(baseTitle, messages) {
+  const title = baseTitle || "Chat";
+  return {
+    id: randomUUID(),
+    name: `Transcript of ${title}.md`,
+    kind: "transcript",
+    content: formatTranscriptMarkdown(title, messages)
+  };
+}
+function createChatTab(input) {
+  const from = requireThread(input.fromThreadId);
+  const binding = worktreeBindingFrom(from);
+  const explicitTitle = input.title?.trim();
+  const title = explicitTitle || allocateTeamName(takenTeamSlugsForChatTab(binding.worktreePath)).name;
+  const nextAgent = input.agent ?? from.agent;
+  if (isOrchestratorThread(from) || binding.sourceType === "orchestration") {
+    assertOrchestratorCapableAgent(nextAgent);
+  }
+  const singletonInbox = isSlackCoordinatorThread(from) || isCloudCoordinatorThread(from);
+  const thread = createEmptyThread({
+    title,
+    // Chat-tab nicknames (soccer team or explicit) must stick. Post-turn
+    // syncThreadBranchFromGit would otherwise rewrite every sibling to the
+    // shared worktree folder name (e.g. fork "Arsenal" → "Monaco").
+    userSetTitle: true,
+    ...binding,
+    // Slack / Brightsy cloud identity stays on the original chat. A + tab
+    // that copies `slack:team:user` would steal inbound DMs after you close
+    // the connected chat.
+    sourceRef: singletonInbox ? title : binding.sourceRef,
+    agent: nextAgent,
+    model: input.model !== void 0 ? input.model : input.agent && input.agent !== from.agent ? null : from.model,
+    effort: input.effort !== void 0 ? input.effort : from.effort,
+    fast: input.fast !== void 0 ? Boolean(input.fast) : from.fast,
+    planMode: from.planMode,
+    autonomy: input.autonomy ?? from.autonomy,
+    attachments: input.attachments ?? [],
+    status: "idle",
+    ...input.accountId !== void 0 ? { accountId: input.accountId } : {},
+    ...mergeWorktreeActiveRuns(threadsSharingWorktree(binding.worktreePath))
+  });
+  writeThread(thread);
+  return thread;
+}
+function forkChatTab(input) {
+  const from = requireThread(input.threadId);
+  const slice = forkMessageSlice(from, input.throughIndex);
+  const attachment = buildForkTranscriptAttachment(from.title || "Chat", slice);
+  const tab = createChatTab({
+    fromThreadId: input.threadId,
+    agent: input.agent ?? from.agent,
+    model: input.model,
+    title: input.title?.trim() || void 0,
+    attachments: [attachment]
+  });
+  if (isOrchestratorThread(from) && tab.parentThreadId !== from.id) {
+    const next = { ...tab, parentThreadId: from.id };
+    writeThread(next);
+    return next;
+  }
+  return tab;
+}
+
+// src/review/review-write-gate.ts
+var REVIEW_TAB_TITLE = "Review";
+function hasLiveReviewSibling(thread, siblings = []) {
+  const selfId = thread.id;
+  return siblings.some(
+    (t) => t.id !== selfId && t.status !== "archived" && t.title.trim() === REVIEW_TAB_TITLE
+  );
+}
+function isReviewWriteGatedThread(thread, siblings) {
+  if (thread.sourceType === "pr" || thread.title.trim() === REVIEW_TAB_TITLE) {
+    return true;
+  }
+  return hasLiveReviewSibling(thread, siblings);
+}
+function formatReviewWriteGateDirective() {
+  return [
+    "Review writes are public. The PR or ticket author sees GitHub/Linear/AbleTime comments, ticket updates, and submitted reviews immediately \u2014 a draft will confuse them.",
+    "Write the recommendation in chat so the user can work through the feedback first. Do not call github_comment, linear_comment, abletime_comment, github_update_issue, linear_update_issue, abletime_update_task, or run `gh pr review` / `gh pr comment`, until they type a next step that asks you to post.",
+    "After the review is in chat, stop. Do not call ask_user. The user needs time to read and will type the next steps. If they already asked you to post a specific comment or update in this turn, that is confirmation.",
+    "Do not request reviewers, change labels, or assign yourself unless they asked \u2014 those also notify the author."
+  ].join("\n");
+}
+function formatReviewWriteGateReminder() {
+  return "Review writes: keep the review in chat. Do not ask_user after it \u2014 they read and type next steps. Do not github_comment / linear_comment / *_update_* / `gh pr review` on the PR or ticket until they ask. Authors see those immediately.";
+}
+
+// src/review/review-request-template.ts
+var REVIEW_REQUEST_TEMPLATE = `# Review guidelines:
+
+You are reviewing a proposed code change so a human can decide whether it is **ready to merge / land**. Findings matter, but the primary deliverable is a clear readiness recommendation \u2014 not a laundry list of style notes.
+
+## Required outcome
+
+Start your reply with a **Recommendation** section using exactly one of:
+
+- **Approve** \u2014 ready to merge as-is (or with only trivial nits the author can ignore).
+- **Approve with nits** \u2014 ready to merge; list only optional polish that should not block.
+- **Request changes** \u2014 not ready; blocking issues must be fixed first.
+- **Needs more information** \u2014 cannot judge readiness yet (missing context, incomplete diff, unclear intent).
+
+In 1\u20133 sentences, say **why** \u2014 grounded in correctness, risk, test coverage, and scope \u2014 not vibes. If you request changes, name the blockers explicitly.
+
+People running this review are asking \u201Ccan we ship this?\u201D Treat that as the question you answer first.
+
+## Confirm before posting
+
+The report stays in this chat until the user posts it. Do not call \`github_comment\`, \`linear_comment\`, \`abletime_comment\`, \`github_update_issue\`, \`linear_update_issue\`, \`abletime_update_task\`, or run \`gh pr review\` / \`gh pr comment\`, until they type a next step that asks you to post.
+
+After the Recommendation is in chat, stop. Do not call ask_user. The user needs time to read the review and will type the next steps. If they already asked you to post a specific comment or update in this turn, that is confirmation.
+
+The PR or ticket author sees those writes immediately \u2014 a draft review will confuse them. Do not request reviewers, change labels, or assign yourself unless they asked.
+
+## Findings
+
+Below are guidelines for determining whether an issue is worth flagging to the original author.
+
+These are not the final word. More specific guidelines elsewhere (developer message, user message, a file, etc.) override these.
+
+Flag something as a bug / blocking finding only when:
+
+1. It meaningfully impacts the accuracy, performance, security, or maintainability of the code.
+2. The bug is discrete and actionable (not a vague codebase-wide complaint or a bundle of unrelated issues).
+3. Fixing it does not demand rigor absent from the rest of the codebase.
+4. The issue was introduced by this change (do not flag pre-existing bugs unless they are newly exposed by this PR).
+5. The author would likely fix it if made aware.
+6. It does not rely on unstated assumptions about the codebase or author intent.
+7. Speculative breakage is not enough \u2014 identify the other code that is provably affected.
+8. It is clearly not just an intentional change by the author.
+
+When flagging an issue, include a short accompanying comment:
+
+1. Clear about why it is a problem.
+2. Severity must match reality \u2014 do not inflate.
+3. Brief: at most one paragraph; avoid unnecessary line breaks in prose.
+4. No code chunks longer than 3 lines; wrap code in inline ticks or a fenced block.
+5. Call out scenarios / environments / inputs needed to hit the bug when severity depends on them.
+6. Matter-of-fact tone \u2014 helpful assistant, not accusatory or effusive.
+7. Skimmable on first read.
+8. No empty flattery (\u201CGreat job\u2026\u201D, \u201CThanks for\u2026\u201D).
+
+HOW MANY FINDINGS TO RETURN:
+
+List every finding the author would fix if they knew about it. If nothing qualifies, say so and still give the Recommendation. Do not stop at the first finding.
+
+GUIDELINES:
+
+- Ignore trivial style unless it obscures meaning or violates documented standards.
+- One comment per distinct issue (or a short multi-line range if needed).
+- Use \`\`\`suggestion blocks ONLY for concrete replacement code (minimal lines; no commentary inside the block).
+- In every \`\`\`suggestion block, preserve the exact leading whitespace of the replaced lines (spaces vs tabs, number of spaces).
+- Do NOT introduce or remove outer indentation levels unless that is the actual fix.
+- Separate **blocking** findings from **nits**. Only blocking findings should drive Request changes.
+
+The report appears in chat (and can become Sideboard diff comments). Avoid unnecessary location chatter in the body; keep line ranges as short as possible (prefer \u22645\u201310 lines).
+
+## Getting the diff
+
+Use Sideboard's diff for this thread's worktree. Prefer the \`get_diff\` MCP tool (pass this thread's ref) for a compact summary, then read specific files with Read/Glob as needed. In the Sideboard desktop app, the Changes panel shows the same worktree diff.
+
+If the user asks you to address or read line comments they added in the Changes / file diff UI, those arrive as \`diff-comment\` attachments on the next turn \u2014 follow them precisely.
+
+## Fallback: if you don't have access to the Sideboard diff tool
+
+If you don't have access to \`get_diff\`, use the following git commands to get the diff:
+
+\`\`\`bash
+# Get the merge base between this branch and the target
+MERGE_BASE=$(git merge-base origin/main HEAD)
+
+# Get the committed diff against the merge base
+git diff $MERGE_BASE HEAD
+
+# Get any uncommitted changes (staged and unstaged)
+git diff HEAD
+\`\`\`
+
+Review the combination of both outputs: the first shows all committed changes on this branch relative to the target, and the second shows any uncommitted work in progress.
+
+No need to mention in your report whether or not you used one of the fallback strategies; it's usually irrelevant.
+
+## Output format
+
+**1. Recommendation first** (required), then **2. Findings** (may be empty).
+
+Only report ONE finding per unique issue.
+
+<example>
+## Recommendation
+
+**Request changes** \u2014 The empty-input crash on load will break first-run users; fix that before merge. The unused helper is a nit and can wait.
+
+## Findings
+
+### **#1 Empty input causes crash** (blocking)
+
+If the input field is empty when the page loads, the app will crash.
+
+File: src/client/frontends/desktop/ui/Input.tsx
+
+### **#2 Dead code** (nit)
+
+The getUserData function is now unused. It should be deleted.
+
+File: src/client/frontends/desktop/core/UserData.ts
+</example>
+
+<example>
+## Recommendation
+
+**Approve** \u2014 Diff is scoped, behavior looks correct, and there are no blocking issues. Safe to merge.
+</example>
+
+## Growing the rules
+
+If a blocking issue is a missing or ambiguous repo rule that will recur, add one sentence to \`.claude/skills/review/SKILL.md\` when that skill already exists. Otherwise write it to \`.context/review.md\` (do not create a review skill). Do not only patch this diff when the same miss will happen again. Do not write new skills under \`.sideboard/skills/\`.
+`;
+var REVIEW_SKILL_PATH = ".claude/skills/review/SKILL.md";
+var REVIEW_SKILL_NAME = "review";
+
+// src/review/request-review.ts
+var REPO_REVIEW_PATH = ".sideboard/review.md";
+var REPO_REVIEW_NAME = "review.md";
+var CONTEXT_REVIEW_PATH = ".context/review.md";
+var REVIEW_REQUEST_PATH = `${ATTACHMENTS_DIR}/Review request.md`;
+var LEGACY_REVIEW_REQUEST_PATH = `${LEGACY_ATTACHMENTS_DIR}/Review request.md`;
+var REVIEW_REQUEST_NAME = "Review request.md";
+var REVIEW_REQUEST_PREFILL = "Review changes in this workspace.";
+var LEGACY_REVIEW_TEMPLATE_MARKERS = [
+  "You are acting as a reviewer for a proposed code change made by another engineer.",
+  "HOW MANY FINDINGS TO RETURN:"
+];
+function shouldRefreshReviewRequestTemplate(content) {
+  const trimmed = content.trim();
+  if (!trimmed) return true;
+  if (/##\s*Recommendation|ready to merge|Approve with nits|Request changes/i.test(trimmed)) {
+    return false;
+  }
+  return LEGACY_REVIEW_TEMPLATE_MARKERS.every((m) => trimmed.includes(m));
+}
+function readTextIfPresent(abs) {
+  if (!existsSync2(abs)) return null;
+  try {
+    const content = readFileSync(abs, "utf8");
+    return content.trim() ? content : null;
+  } catch {
+    return null;
+  }
+}
+function readLocalGuidelines(worktreePath) {
+  const localAbs = join2(worktreePath, REVIEW_REQUEST_PATH);
+  const localContent = readTextIfPresent(localAbs);
+  if (localContent && !shouldRefreshReviewRequestTemplate(localContent)) {
+    return { path: REVIEW_REQUEST_PATH, content: localContent };
+  }
+  const legacyAbs = join2(worktreePath, LEGACY_REVIEW_REQUEST_PATH);
+  const legacyContent = readTextIfPresent(legacyAbs);
+  if (legacyContent && !shouldRefreshReviewRequestTemplate(legacyContent)) {
+    return { path: LEGACY_REVIEW_REQUEST_PATH, content: legacyContent };
+  }
+  return null;
+}
+function skillGuidelines(content, source) {
+  return {
+    path: REVIEW_SKILL_PATH,
+    name: REVIEW_SKILL_NAME,
+    content,
+    source
+  };
+}
+function contextGuidelines(content, source) {
+  return {
+    path: CONTEXT_REVIEW_PATH,
+    name: REPO_REVIEW_NAME,
+    content,
+    source
+  };
+}
+function writeContextGuidelines(worktreePath, content) {
+  const abs = join2(worktreePath, CONTEXT_REVIEW_PATH);
+  mkdirSync2(dirname(abs), { recursive: true });
+  const body = content.endsWith("\n") ? content : `${content}
+`;
+  writeFileSync(abs, body, "utf8");
+  return body;
+}
+function readSideboardReview(worktreePath, repoPath) {
+  const fromWorktree = readTextIfPresent(join2(worktreePath, REPO_REVIEW_PATH));
+  if (fromWorktree) return fromWorktree;
+  const repo = repoPath?.replace(/\/+$/, "");
+  const wt = worktreePath.replace(/\/+$/, "");
+  if (!repo || repo === wt) return null;
+  return readTextIfPresent(join2(repo, REPO_REVIEW_PATH));
+}
+function ensureReviewGuidelinesFile(worktreePath, repoPath) {
+  const skillContent = readTextIfPresent(join2(worktreePath, REVIEW_SKILL_PATH));
+  if (skillContent) {
+    return { ...skillGuidelines(skillContent, "skill"), wrote: false };
+  }
+  const contextContent = readTextIfPresent(join2(worktreePath, CONTEXT_REVIEW_PATH));
+  if (contextContent && !shouldRefreshReviewRequestTemplate(contextContent)) {
+    return { ...contextGuidelines(contextContent, "local"), wrote: false };
+  }
+  const fromSideboard = readSideboardReview(worktreePath, repoPath);
+  if (fromSideboard && !shouldRefreshReviewRequestTemplate(fromSideboard)) {
+    const body2 = writeContextGuidelines(worktreePath, fromSideboard);
+    return { ...contextGuidelines(body2, "repo"), wrote: true };
+  }
+  const local = readLocalGuidelines(worktreePath);
+  const body = writeContextGuidelines(worktreePath, local?.content ?? REVIEW_REQUEST_TEMPLATE);
+  return {
+    ...contextGuidelines(body, local ? "local" : "stock"),
+    wrote: true
+  };
+}
+function resolveReviewGuidelines(worktreePath, repoPath) {
+  return ensureReviewGuidelinesFile(worktreePath, repoPath);
+}
+function buildReviewRequestAttachment(content, opts) {
+  const path = opts?.path ?? REVIEW_SKILL_PATH;
+  const name = opts?.name ?? (path === REVIEW_SKILL_PATH ? REVIEW_SKILL_NAME : path === REPO_REVIEW_PATH || path === CONTEXT_REVIEW_PATH ? REPO_REVIEW_NAME : REVIEW_REQUEST_NAME);
+  return {
+    id: randomUUID2(),
+    name,
+    kind: "file",
+    path,
+    content
+  };
+}
+function canReuseIdleWorktreeAgentForReview(from, siblings) {
+  const live = siblings.filter((t) => t.status !== "archived");
+  if (live.length !== 1) return false;
+  const only = live[0];
+  if (only.id !== from.id) return false;
+  if (from.status !== "idle") return false;
+  if ((from.queue?.length ?? 0) > 0) return false;
+  return (from.messages?.length ?? 0) === 0 && (only.messages?.length ?? 0) === 0;
+}
+function reviewGuidelinesAttachment(from) {
+  const guidelines = resolveReviewGuidelines(from.worktreePath, from.repoPath);
+  return buildReviewRequestAttachment(guidelines.content, {
+    path: guidelines.path,
+    name: guidelines.name
+  });
+}
+async function requestReview(threadRef, send) {
+  const from = findThreadByRef(threadRef);
+  if (!from) throw new Error(`Thread not found: ${threadRef}`);
+  if (isOrchestratorThread(from)) {
+    throw new Error(
+      "request_review targets a worktree agent thread (not the orchestrator). Pass a child/worktree thread ref."
+    );
+  }
+  if (from.status === "archived") {
+    throw new Error(`Thread is archived: ${from.id}`);
+  }
+  const attachment = reviewGuidelinesAttachment(from);
+  const siblings = threadsSharingWorktree(from.worktreePath);
+  if (canReuseIdleWorktreeAgentForReview(from, siblings)) {
+    const reused = updateThread(from.id, {
+      title: REVIEW_TAB_TITLE,
+      userSetTitle: true,
+      attachments: [...from.attachments ?? [], attachment]
+    });
+    const started2 = await send(reused.id, REVIEW_REQUEST_PREFILL);
+    return { tab: started2, from: reused };
+  }
+  const tab = createChatTab({
+    fromThreadId: from.id,
+    title: REVIEW_TAB_TITLE,
+    attachments: [attachment]
+  });
+  const started = await send(tab.id, REVIEW_REQUEST_PREFILL);
+  return { tab: started, from };
+}
+
+// src/hook/worktree-run-ports.ts
+import { mkdirSync as mkdirSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+import { dirname as dirname2, join as join3 } from "path";
+var RUN_PORTS_REL = ".context/.sideboard/run-ports.json";
+function worktreeRunPortsPath(worktreePath) {
+  return join3(worktreePath, RUN_PORTS_REL);
+}
+function isPort(value) {
+  return typeof value === "number" && Number.isInteger(value) && value > 0 && value <= 65535;
+}
+function parseFile(raw) {
+  try {
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== "object") return {};
+    const scripts = parsed.scripts;
+    if (!scripts || typeof scripts !== "object") return {};
+    const next = {};
+    for (const [name, ports] of Object.entries(scripts)) {
+      if (!name || !Array.isArray(ports)) continue;
+      const cleaned = ports.filter(isPort);
+      if (cleaned.length) next[name] = cleaned;
+    }
+    return { scripts: next };
+  } catch {
+    return {};
+  }
+}
+function readScripts(worktreePath) {
+  if (!worktreePath.trim()) return {};
+  try {
+    const raw = readFileSync2(worktreeRunPortsPath(worktreePath), "utf8");
+    return parseFile(raw).scripts ?? {};
+  } catch {
+    return {};
+  }
+}
+function loadWorktreeRunPorts(worktreePath, scriptName) {
+  if (!scriptName.trim()) return null;
+  const ports = readScripts(worktreePath)[scriptName];
+  return ports?.length ? ports : null;
+}
+function loadOtherScriptRunPorts(worktreePath, scriptName) {
+  const scripts = readScripts(worktreePath);
+  const ports = [];
+  for (const [name, list] of Object.entries(scripts)) {
+    if (name === scriptName) continue;
+    ports.push(...list);
+  }
+  return ports;
+}
+function saveWorktreeRunPorts(worktreePath, scriptName, ports) {
+  if (!worktreePath.trim() || !scriptName.trim()) return;
+  const cleaned = ports.filter(isPort);
+  if (!cleaned.length) return;
+  const path = worktreeRunPortsPath(worktreePath);
+  let current = {};
+  try {
+    current = parseFile(readFileSync2(path, "utf8"));
+  } catch {
+    current = {};
+  }
+  const scripts = { ...current.scripts ?? {} };
+  scripts[scriptName] = cleaned;
+  mkdirSync3(dirname2(path), { recursive: true });
+  writeFileSync2(path, `${JSON.stringify({ scripts }, null, 2)}
+`, "utf8");
+}
+
+// src/mcp/wait-for-job.ts
+import {
+  appendFileSync,
+  existsSync as existsSync3,
+  mkdirSync as mkdirSync4,
+  readdirSync,
+  readFileSync as readFileSync3,
+  writeFileSync as writeFileSync3
+} from "fs";
+import { dirname as dirname3, join as join4 } from "path";
+
+// src/orchestrator/task-state.ts
+function isIncompleteTaskState(state) {
+  return state === "failed" || state === "canceled";
+}
+function needsCoordinatorAction(state) {
+  return isIncompleteTaskState(state) || state === "input-required";
+}
+var ASK_USER_TOOL = /(^|[_.:/])ask_user$/i;
+function endedOnAskUser(parts) {
+  if (!parts?.length) return false;
+  for (let i = parts.length - 1; i >= 0; i--) {
+    const p = parts[i];
+    if (p.type === "tool" && !p.parentId) {
+      return ASK_USER_TOOL.test(p.name);
+    }
+  }
+  return false;
+}
+function deriveTaskState(input) {
+  if (input.stillRunning) {
+    return input.status === "queued" ? "submitted" : "working";
+  }
+  switch (input.status) {
+    case "error":
+    case "broken":
+      return "failed";
+    case "stopped":
+      return "canceled";
+    default:
+      return endedOnAskUser(input.lastAgentParts) ? "input-required" : "completed";
+  }
+}
+
+// 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_chat 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_chat 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_chat 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_chat 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;
+  }
+}
+function nonemptyIso(value) {
+  const trimmed = value?.trim();
+  return trimmed ? trimmed : null;
+}
+function lastActivityAtForWait(stillRunning, liveUpdatedAt, fallbacks) {
+  if (stillRunning) return nonemptyIso(liveUpdatedAt);
+  for (const value of fallbacks) {
+    const iso = nonemptyIso(value);
+    if (iso) return iso;
+  }
+  return null;
+}
+function waitForTurnToolResult(input) {
+  return {
+    ...input,
+    usage: input.usage ?? null,
+    hint: mcpWaitTaskHint(input.taskState, input.status),
+    incomplete: needsCoordinatorAction(input.taskState)
+  };
+}
+
+// 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;
+}
+function jobAlive(pid) {
+  if (!Number.isInteger(pid) || pid <= 0) return false;
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+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 Boolean(err && typeof err === "object" && "code" in err && err.code === "EPERM");
+  }
+}
+function jobTreeAlive(pid) {
+  if (pid == null) return false;
+  return jobAlive(pid) || processGroupAlive(pid);
+}
+function readIntFile(file) {
+  if (!existsSync3(file)) return null;
+  const n = Number.parseInt(readFileSync3(file, "utf8").trim(), 10);
+  return Number.isInteger(n) ? n : null;
+}
+function jobDir(root, id, legacy = false) {
+  return join4(root, legacy ? LEGACY_DETACHED_JOBS_DIR : DETACHED_JOBS_DIR, id);
+}
+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 listJobIdsIn(root, rel) {
+  const dir = join4(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 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(join4(dir, "pid"));
+    if (jobTreeAlive(pid)) running.push(id);
+  }
+  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 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 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 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 out;
+}
+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 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);
+  });
+}
+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 (looksLikeDeferredDonePromise(opts.chatText) && !opts.alreadyNudged) {
+    return { action: "nudge", prompt: formatDeferredDoneContinuePrompt() };
+  }
+  return { action: "none" };
+}
+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 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 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 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 snapshotJob(dir) {
+  const pid = readIntFile(join4(dir, "pid"));
+  const running = jobTreeAlive(pid);
+  return {
+    pid,
+    running,
+    exitCode: readIntFile(join4(dir, "exit")),
+    log: join4(dir, "log"),
+    cursor: join4(dir, "present.cursor"),
+    progress: tailProgress(join4(dir, "log"))
+  };
+}
+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 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 (!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);
+}
+function killProcessTree(pid, signal) {
+  if (!Number.isInteger(pid) || pid <= 0) return;
+  if (process.platform !== "win32") {
+    try {
+      process.kill(-pid, signal);
+      return;
+    } catch {
+    }
+  }
+  try {
+    process.kill(pid, signal);
+  } catch {
+  }
+}
+function appendJobLog(logFile, line) {
+  try {
+    mkdirSync4(dirname3(logFile), { recursive: true });
+    const body = line.endsWith("\n") ? line : `${line}
+`;
+    appendFileSync(logFile, body);
+  } catch {
+  }
+}
+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"
+    };
+  }
+  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 = join4(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 {
+    ...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
+  };
+}
+
+// src/hook/port-range.ts
+import { createServer } from "net";
+var PORT_RANGE_SIZE = 10;
+var RECLAIM_RETRY_DELAY_MS = 40;
+var RECLAIM_TRIES = 8;
+async function killReclaimable(ports, worktreePath, signal) {
+  const { killListenersOnPorts: killListenersOnPorts2, killStaleWorktreeListeners: killStaleWorktreeListeners2 } = await import("./conductor-NRKTEN5X.js");
+  if (worktreePath) killStaleWorktreeListeners2(ports, worktreePath, signal);
+  else killListenersOnPorts2(ports);
+}
+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);
+  });
+}
+async function allocatePort() {
+  const held = await reservePort();
+  await held.release();
+  return held.port;
+}
+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 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 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 delay(ms) {
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
+}
+function portSet(ports) {
+  const out = /* @__PURE__ */ new Set();
+  for (const port of ports ?? []) {
+    if (Number.isInteger(port) && port > 0 && port <= 65535) out.add(port);
+  }
+  return out;
+}
+async function reservePortOutside(avoid) {
+  const skipped = [];
+  try {
+    for (let i = 0; i < 32; i++) {
+      const held = await reservePort();
+      if (!avoid.has(held.port)) {
+        await Promise.all(skipped.map((h) => h.release()));
+        return held;
+      }
+      skipped.push(held);
+    }
+  } catch (err) {
+    await Promise.all(skipped.map((h) => h.release()));
+    throw err;
+  }
+  await Promise.all(skipped.map((h) => h.release()));
+  throw new Error(
+    "Failed to allocate a port that is not reserved by another run script"
+  );
+}
+async function fillPortRange(held, size, avoid) {
+  if (held.length >= size) return held;
+  const base = held[0]?.port;
+  const taken = /* @__PURE__ */ new Set([...held.map((h) => h.port), ...avoid]);
+  try {
+    let offset = 0;
+    while (held.length < size) {
+      const candidate = base != null ? base + offset : null;
+      offset += 1;
+      if (candidate != null && (taken.has(candidate) || candidate > 65535)) {
+        if (candidate > 65535) {
+          const ephemeral = await reservePortOutside(avoid);
+          held.push(ephemeral);
+          taken.add(ephemeral.port);
+        }
+        continue;
+      }
+      const next = candidate != null ? await tryReservePort(candidate) : null;
+      if (next && !avoid.has(next.port)) {
+        held.push(next);
+        taken.add(next.port);
+      } else {
+        if (next) await next.release();
+        const ephemeral = await reservePortOutside(avoid);
+        held.push(ephemeral);
+        taken.add(ephemeral.port);
+      }
+    }
+    return held;
+  } catch (err) {
+    await Promise.all(held.map((h) => h.release()));
+    throw err;
+  }
+}
+async function tryReserveAvailablePorts(ports) {
+  const held = [];
+  for (const port of ports) {
+    const next = await tryReservePort(port);
+    if (next) held.push(next);
+  }
+  return held;
+}
+async function reclaimPreferredPorts(ports, worktreePath, avoid) {
+  const reclaimable = ports.filter((p) => !avoid.has(p));
+  const primary = reclaimable[0];
+  if (primary == null || avoid.has(ports[0] ?? primary)) return null;
+  const takePrimary = async () => {
+    const held2 = await tryReserveAvailablePorts(reclaimable);
+    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;
+  await killReclaimable(reclaimable, worktreePath, "SIGTERM");
+  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) {
+      await killReclaimable(reclaimable, worktreePath, "SIGKILL");
+    }
+  }
+  return null;
+}
+async function reservePortRange(size = PORT_RANGE_SIZE, opts) {
+  const avoid = portSet(opts?.avoid);
+  const preferred = normalizePreferredPorts(opts?.preferred, size);
+  const primary = preferred[0];
+  if (preferred.length && (primary == null || !avoid.has(primary))) {
+    const reused = await reclaimPreferredPorts(
+      preferred,
+      opts?.worktreePath,
+      avoid
+    );
+    if (reused) return fillPortRange(reused, size, avoid);
+  }
+  const held = [await reservePortOutside(avoid)];
+  return fillPortRange(held, size, avoid);
+}
+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;
+}
+
+// src/hook/conductor.ts
+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 (!existsSync4(path)) return [];
+  return readFileSync4(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 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 defaults = [];
+  try {
+    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 copyConfiguredFiles(repoPath, worktreePath) {
+  const patterns = resolveFilesToCopy(repoPath);
+  const copied = [];
+  for (const rel of patterns) {
+    const src = join5(repoPath, rel);
+    if (!existsSync4(src)) continue;
+    const dest = join5(worktreePath, rel);
+    mkdirSync5(dirname4(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 execa(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 };
+}
+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 pipeLines(stream, onLine) {
+  if (!stream || !onLine) return;
+  const rl = createInterface({ input: stream });
+  rl.on("line", onLine);
+}
+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 pids;
+}
+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 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 realpathOrResolve(path) {
+  try {
+    return realpathSync(path);
+  } catch {
+    return resolve(path);
+  }
+}
+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;
+}
+function signalPid(pid, signal) {
+  try {
+    process.kill(pid, signal);
+  } catch {
+  }
+}
+function isThisWorktreeListenerCwd(cwd, worktreePath) {
+  const wt = realpathOrResolve(worktreePath);
+  const c = realpathOrResolve(cwd);
+  return c === wt || c.startsWith(wt + sep);
+}
+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 {
+    process.kill(-pid, "SIGTERM");
+  } catch {
+    signalPid(pid, "SIGTERM");
+  }
+}
+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 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 killScriptTree(child, ports = []) {
+  const pid = child.pid;
+  if (pid) {
+    try {
+      if (process.platform === "win32") {
+        void execa("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);
+}
+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 = execa(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
+  };
+}
+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;
+}
+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
+  };
+}
+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 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);
+  }
+  if (!setup.ran) {
+    setup = await runConventionSetup(repoPath, worktreePath, onLine, opts);
+  }
+  return setup;
+}
+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 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 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 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 getRunMode(worktreePath, repoPath) {
+  return loadWorkspaceSettings(worktreePath, repoPath)?.runMode ?? "concurrent";
+}
+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,
+    avoid: loadOtherScriptRunPorts(worktreePath, script.name)
+  });
+  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;
+  }
+}
+
+export {
+  needsCoordinatorAction,
+  deriveTaskState,
+  mcpWaitForTurnTimeoutMs,
+  mcpWaitTaskHint,
+  lastActivityAtForWait,
+  waitForTurnToolResult,
+  applyWorktreePkgCacheEnv,
+  buildSessionSeed,
+  buildBrightsySessionSeed,
+  maybeCompactContext,
+  worktreeSetupProcessKey,
+  worktreeRunProcessKey,
+  worktreeDevProcessKey,
+  isWorktreeRunProcessKey,
+  resolveWorktreeSetupLog,
+  mergeWorktreeActiveRuns,
+  threadsSharingWorktree,
+  forkMessageSlice,
+  buildForkTranscriptAttachment,
+  createChatTab,
+  forkChatTab,
+  REVIEW_TAB_TITLE,
+  isReviewWriteGatedThread,
+  formatReviewWriteGateDirective,
+  formatReviewWriteGateReminder,
+  requestReview,
+  RUN_PORTS_REL,
+  worktreeRunPortsPath,
+  loadWorktreeRunPorts,
+  saveWorktreeRunPorts,
+  mcpWaitForJobTimeoutMs,
+  listRunningDetachedJobs,
+  isJobContinuePrompt,
+  turnWatchedDetachedJob,
+  planJobContinue,
+  waitForDetachedJob,
+  stopDetachedJob,
+  PORT_RANGE_SIZE,
+  reservePort,
+  allocatePort,
+  tryReservePort,
+  tryReservePorts,
+  reservePortRange,
+  allocatePortRange,
+  readWorktreeInclude,
+  resolveFilesToCopy,
+  copyConfiguredFiles,
+  captureLoginEnv,
+  buildWorkspaceScriptEnv,
+  killableListenerPids,
+  listenerCwd,
+  isOtherWorktreeListenerCwd,
+  isThisWorktreeListenerCwd,
+  killDetachedRunTree,
+  killListenersOnPorts,
+  killStaleWorktreeListeners,
+  runSetupScript,
+  runConventionSetup,
+  runWorkspaceSetup,
+  runArchiveScript,
+  listRunScripts,
+  getDefaultRunScript,
+  getRunScript,
+  getRunMode,
+  startDevServer
+};