@sideboard-ai/core 0.1.279 → 0.1.281

package/dist/{chunk-CPGJ5ICZ.js → chunk-BYZ7F2BQ.js}

@@ -23,7 +23,7 @@ import {
   parseSessionQuotaResetAt,
   planModeTurnInstruction,
   resolveQuotaFallbackAgent
-} from "./chunk-RK5PIWCW.js";
+} from "./chunk-ADXVTKLC.js";
 import {
   REVIEW_TAB_TITLE,
   applyWorktreePkgCacheEnv,
@@ -62,7 +62,7 @@ import {
   worktreeDevProcessKey,
   worktreeRunProcessKey,
   worktreeSetupProcessKey
-} from "./chunk-YDXNCBA2.js";
+} from "./chunk-EIEAR62M.js";
 import {
   applyAgentEvent,
   clipAgentEventForPaint,
@@ -88,7 +88,7 @@ import {
   summarizeTurnStderr,
   toolDescription,
   turnFailChatText
-} from "./chunk-CPA43FBK.js";
+} from "./chunk-W7HIK2A6.js";
 import {
   SLACK_REPLY_FORMATTING,
   addWorkspace,
@@ -103,16 +103,18 @@ import {
   isGlobalRepoPath,
   isGlobalThread,
   isOrchestratorThread,
+  isRemovedWorkspace,
+  listWorkspaces,
   orchestratorSessionPoisonedByBuiltins,
   persistPendingFileAttachments,
   removeWorkspace,
+  sameWorkspacePath,
   stageAbsolutePathsAsAttachments,
   stageBuffersAsAttachments,
   syncWorkspacesFromThreads
-} from "./chunk-TZ5JHIYK.js";
+} from "./chunk-2SJXQ4UX.js";
 import {
   addPrStackLayer,
-  agentNicknameFromWorktreePath,
   allocateTeamSlug,
   canonicalizeRepoPath,
   ciChecksFailed,
@@ -137,14 +139,11 @@ import {
   getPrStack,
   initPrStack,
   isDirty,
-  isPlaceholderBranch,
   isSideboardScratchPath,
-  isWorktreeIdentityTitle,
   listWorktrees,
   markPrReady,
   mergeAgentGitAuthEnv,
   mergePr,
-  normalizeWorktreePath,
   pushBranch,
   removeWorktree,
   resolveAgentGitAuthEnv,
@@ -154,14 +153,8 @@ import {
   resolvePrSelector,
   resolveRepoRoot,
   switchWorktreeBranch,
-  teamSlugFromName,
-  ticketSlugForBranch,
-  withRepoGitLock,
-  worktreeDisplayLabelForGroup,
-  worktreeIdentityTitles,
-  worktreeNameFromPath,
-  worktreeSlugForTicket
-} from "./chunk-K7MWJLR7.js";
+  withRepoGitLock
+} from "./chunk-5MGLNVNK.js";
 import {
   clearStaleIndexLocks,
   enrichPathWithNpmGlobalBin,
@@ -191,14 +184,17 @@ import {
   orchestrationQuotaFallbackAgent,
   planHistoryAgePurge,
   planHistoryRetention,
+  readViewerContext,
   resolveEffectiveIssueSource,
   resolveNewThreadOptions,
   resolveOrchestratorDefaults,
   resolveViewerProfileForRepo,
   sumUsageList,
   updateAdvancedSettings,
+  updateAppEnvironment,
   usageOnLimit,
-  withTurnScopedCost
+  withTurnScopedCost,
+  writeViewerContext
 } from "./chunk-WRIMAEF2.js";
 import {
   writePrivateFile
@@ -214,17 +210,29 @@ import {
   resolveAccountForThread
 } from "./chunk-UN5Q7POQ.js";
 import {
+  agentNicknameFromWorktreePath,
   appendMessage,
   createEmptyThread,
   deleteThreadRecord,
   findThreadByRef,
+  isPlaceholderBranch,
+  isWorktreeIdentityTitle,
   listThreads,
+  normalizeWorkspaceTags,
+  normalizeWorktreePath,
   readThread,
   setStatus,
+  teamSlugFromName,
+  ticketSlugForBranch,
   updateThread,
   withThreadLock,
+  workspaceTagsFromGroup,
+  worktreeDisplayLabelForGroup,
+  worktreeIdentityTitles,
+  worktreeNameFromPath,
+  worktreeSlugForTicket,
   writeThread
-} from "./chunk-JANCPF7Z.js";
+} from "./chunk-JPH7PYSK.js";
 import {
   annotateDevAccessRuns,
   appDataDir,
@@ -240,11 +248,11 @@ import {
 import { EventEmitter } from "events";
 
 // src/threads/injected-notices.ts
-function isSlackExternalReplyText(text) {
-  return text.startsWith("Slack reply from ") && text.includes("not a command");
+function isSlackExternalReplyText(text3) {
+  return text3.startsWith("Slack reply from ") && text3.includes("not a command");
 }
-function isInjectedNoticeText(text) {
-  return isSlackExternalReplyText(text);
+function isInjectedNoticeText(text3) {
+  return isSlackExternalReplyText(text3);
 }
 function pendingInjectedNotices(messages, match = isInjectedNoticeText) {
   let i = messages.length - 1;
@@ -278,7 +286,7 @@ function formatInjectedNoticesForTurn(notices) {
 }
 
 // src/orchestrator/orchestrator.ts
-import { randomUUID as randomUUID3 } from "crypto";
+import { randomUUID as randomUUID4 } from "crypto";
 import { existsSync as existsSync14 } from "fs";
 
 // src/agents/spawn.ts
@@ -325,8 +333,8 @@ function textSoFar(parts, parentId) {
   }
   return out;
 }
-function replaySized(text) {
-  return text.trim().length >= REPLAY_MIN_CHARS;
+function replaySized(text3) {
+  return text3.trim().length >= REPLAY_MIN_CHARS;
 }
 function tailAfterAccumulated(accumulated, incoming) {
   if (incoming.startsWith(accumulated)) return incoming.slice(accumulated.length);
@@ -489,9 +497,9 @@ async function spawnAgentTurn(thread, input, onEvent) {
       `Cannot spawn ${thread.agent}: thread ${thread.id} has no worktreePath`
     );
   }
-  const { isGlobalThread: isGlobalThread2 } = await import("./global-workspace-5PJXO45Z.js");
+  const { isGlobalThread: isGlobalThread2 } = await import("./global-workspace-UPUDWIS6.js");
   if (isGlobalThread2(thread)) {
-    const { ensureGlobalCoordinatorCwd: ensureGlobalCoordinatorCwd2 } = await import("./coordinator-prompt-ERTHREGJ.js");
+    const { ensureGlobalCoordinatorCwd: ensureGlobalCoordinatorCwd2 } = await import("./coordinator-prompt-SVVGU6AZ.js");
     ensureGlobalCoordinatorCwd2(
       isOrchestratorThread(thread) ? { orchestratorThreadId: thread.id } : void 0
     );
@@ -633,10 +641,10 @@ async function spawnAgentTurn(thread, input, onEvent) {
     outbound.flush();
     const finalized = finalizeParts(parts);
     const rawText = assistantText.trim() || partsToAssistantText(finalized);
-    const text = thread.agent === "brightsy" ? stripBrightsyNdjsonNoise(rawText) : rawText;
-    const exitCode = thread.agent === "brightsy" ? adjustBrightsyTurnExit(result.exitCode ?? null, text) : result.exitCode ?? null;
+    const text3 = thread.agent === "brightsy" ? stripBrightsyNdjsonNoise(rawText) : rawText;
+    const exitCode = thread.agent === "brightsy" ? adjustBrightsyTurnExit(result.exitCode ?? null, text3) : result.exitCode ?? null;
     onEvent({ type: "exit", data: exitCode });
-    return { exitCode, sessionId, assistantText: text, parts: finalized, usage };
+    return { exitCode, sessionId, assistantText: text3, parts: finalized, usage };
   });
   return {
     pid: child.pid,
@@ -1066,8 +1074,8 @@ function sliceRunLogOutput(output, tailChars = DEFAULT_RUN_LOG_TAIL_CHARS) {
   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 };
+  const text3 = nl >= 0 && nl < cut.length - 1 ? cut.slice(nl + 1) : cut;
+  return { output: text3, truncated: true, outputChars };
 }
 var PERSIST_DEBOUNCE_MS2 = 500;
 function persistNow2(key) {
@@ -1428,7 +1436,7 @@ async function cloneRepoIntoSideboard(opts) {
   const dest = join5(sideboardReposDir(), name);
   if (existsSync4(dest)) {
     const repoPath2 = await resolveRepoRoot(dest);
-    const workspace2 = await ensureWorkspace(repoPath2);
+    const workspace2 = await addWorkspace(repoPath2);
     return { repoPath: repoPath2, workspace: workspace2 };
   }
   const result = await execa3("git", ["clone", url, dest], { reject: false });
@@ -1438,7 +1446,7 @@ async function cloneRepoIntoSideboard(opts) {
     );
   }
   const repoPath = await resolveRepoRoot(dest);
-  const workspace = await ensureWorkspace(repoPath);
+  const workspace = await addWorkspace(repoPath);
   return { repoPath, workspace };
 }
 
@@ -1486,9 +1494,9 @@ function thisProcessShouldDrainAgentQueues() {
 var MAX_NOTIFY_ORCHESTRATOR_MESSAGE_CHARS = 1500;
 var inputRequiredNotified = /* @__PURE__ */ new Set();
 function clampMessage(raw) {
-  const text = raw.replace(/\s+/g, " ").trim();
-  if (text.length <= MAX_NOTIFY_ORCHESTRATOR_MESSAGE_CHARS) return text;
-  return `${text.slice(0, MAX_NOTIFY_ORCHESTRATOR_MESSAGE_CHARS - 1)}\u2026`;
+  const text3 = raw.replace(/\s+/g, " ").trim();
+  if (text3.length <= MAX_NOTIFY_ORCHESTRATOR_MESSAGE_CHARS) return text3;
+  return `${text3.slice(0, MAX_NOTIFY_ORCHESTRATOR_MESSAGE_CHARS - 1)}\u2026`;
 }
 function formatAskUserNotifyMessage(questions) {
   const qs = questions.map((q) => q.question?.trim() ?? "").filter(Boolean);
@@ -1580,10 +1588,10 @@ async function notifyOrchestrator(input) {
 // src/orchestrator/agent-block.ts
 var MAX_AGENT_BLOCK_REASON = 240;
 function clampBlockReason(raw) {
-  const text = raw.replace(/\s+/g, " ").trim();
-  if (!text) return "Waiting on a decision";
-  if (text.length <= MAX_AGENT_BLOCK_REASON) return text;
-  return `${text.slice(0, MAX_AGENT_BLOCK_REASON - 1)}\u2026`;
+  const text3 = raw.replace(/\s+/g, " ").trim();
+  if (!text3) return "Waiting on a decision";
+  if (text3.length <= MAX_AGENT_BLOCK_REASON) return text3;
+  return `${text3.slice(0, MAX_AGENT_BLOCK_REASON - 1)}\u2026`;
 }
 function makeAgentBlock(source, reason, at = (/* @__PURE__ */ new Date()).toISOString()) {
   return { source, reason: clampBlockReason(reason), at };
@@ -1725,6 +1733,45 @@ function notifyParentOfChildHalt(child, status, send) {
   return true;
 }
 
+// src/orchestrator/stop-reason.ts
+var STOP_REASON_MAX = 500;
+function resolveStopReason(opts) {
+  const explicit = opts?.reason?.trim();
+  if (explicit) return explicit.slice(0, STOP_REASON_MAX);
+  if (opts?.continueQueue) return "Stopped to send the next prompt";
+  if (opts?.clearQueue === false) return "Stopped by the user";
+  return "Stopped (queue cleared)";
+}
+function reasonToKeepOnStop(existing, incoming) {
+  const next = incoming?.trim();
+  if (next) return next.slice(0, STOP_REASON_MAX);
+  const prior = existing?.trim();
+  if (prior) return prior.slice(0, STOP_REASON_MAX);
+  return "Stopped";
+}
+function writeStoppedStatus(threadId, reason) {
+  const latest = readThread(threadId);
+  if (!latest || latest.status === "archived") return latest;
+  return setStatus(threadId, "stopped", reasonToKeepOnStop(latest.lastError, reason));
+}
+
+// src/orchestrator/steer-request.ts
+import { randomUUID } from "crypto";
+function isUnclaimedSteerRequest(req) {
+  return Boolean(req?.requestId && !req.claimedAt);
+}
+function nextSteerRequest(existing) {
+  if (existing?.requestId && !existing.claimedAt) return existing;
+  return { requestId: randomUUID(), requestedAt: (/* @__PURE__ */ new Date()).toISOString() };
+}
+function claimSteerRequest(threadId) {
+  const pending = readThread(threadId)?.steerRequest;
+  if (!pending?.requestId || pending.claimedAt) return;
+  updateThread(threadId, {
+    steerRequest: { ...pending, claimedAt: (/* @__PURE__ */ new Date()).toISOString() }
+  });
+}
+
 // src/threads/agent-purpose-title.ts
 function agentPurposeStamp(input) {
   if (input.autoContinue) return null;
@@ -2146,7 +2193,8 @@ function threadSearchText(thread, workspaceName = "") {
     thread.branchName,
     thread.prUrl ?? "",
     workspaceName,
-    thread.repoPath
+    thread.repoPath,
+    ...thread.tags ?? []
   ].join(" ");
 }
 function inWorkspace(repoPath, filterRepoPath) {
@@ -2205,6 +2253,7 @@ function findBoardPr(prs, ref, repoPath = "") {
 function toThreadCard(group) {
   const thread = group[0];
   const withPr = group.find((t) => t.prUrl?.trim()) ?? thread;
+  const tags = workspaceTagsFromGroup(group);
   return {
     kind: "thread",
     id: thread.id,
@@ -2217,7 +2266,8 @@ function toThreadCard(group) {
     prUrl: withPr.prUrl,
     link: `sideboard://chat/${thread.id}`,
     ...group.length > 1 ? { chatCount: group.length } : {},
-    ...threadCardBlockFields(group) ?? {}
+    ...threadCardBlockFields(group) ?? {},
+    ...tags.length > 0 ? { tags } : {}
   };
 }
 function threadMatchesKind(thread, kind) {
@@ -2293,6 +2343,51 @@ function assembleHomeBoard(input) {
 }
 var HOME_BOARD_AGENT_HINT = "Home is a Kanban of workspaces (one card per checkout; sibling chats on a card are separate agents). Do not create a second workspace for a ticket, PR, or named branch that already has a live checkout \u2014 create_workspace / start_board_card return that checkout (alreadyStarted) and its chats. Add another agent with fork_chat. Creating from the default branch still opens a new isolated workspace. Columns are the path to merge: New (no PR) \u2192 Draft (draft PR) \u2192 Review (open PR) \u2192 Merged. ownership=mine is PRs you authored (or WIP with no PR); ownership=reviewing is someone else's PR (or a review-requested checkout). Viewer login comes from gh, not a setting. Archive removes the card to Settings \u2192 History. Queued/running are activity on the card, not columns. blockedReason means an agent on that card is waiting on a person (the question, plan approval, or a reported block) \u2014 read it and do not send_to_chat a check-in. Orchestration chats stay in the sidebar. Do not invent status.";
 
+// src/threads/workspace-tags.ts
+function workspaceTagTargetRef(opts) {
+  const requested = opts.requestedRef?.trim() || "";
+  if (!opts.ownWorktreeOnly) {
+    if (!requested) throw new Error("Pass a chat id on the workspace to label.");
+    return requested;
+  }
+  const caller = opts.caller;
+  if (!caller || isGlobalThread(caller) || caller.sourceType === "orchestration") {
+    throw new Error("Tags belong on a project workspace. This chat is not one.");
+  }
+  if (!requested || requested === caller.id) return caller.id;
+  const other = opts.find(requested);
+  if (!other || normalizeWorktreePath(other.worktreePath) !== normalizeWorktreePath(caller.worktreePath)) {
+    throw new Error("You can only change tags on this workspace.");
+  }
+  return other.id;
+}
+function applyWorkspaceTags(threadRef, tags, mode = "replace") {
+  const thread = findThreadByRef(threadRef);
+  if (!thread) throw new Error(`Thread not found: ${threadRef}`);
+  if (isGlobalThread(thread) || thread.sourceType === "orchestration") {
+    throw new Error("Tags belong on a project workspace. Pass a worktree chat id.");
+  }
+  const incoming = normalizeWorkspaceTags(tags);
+  const siblings = threadsSharingWorktree(thread.worktreePath);
+  const current = workspaceTagsFromGroup(siblings.length > 0 ? siblings : [thread]);
+  let next;
+  if (mode === "add") {
+    next = normalizeWorkspaceTags([...current, ...incoming]);
+  } else if (mode === "remove") {
+    const drop = new Set(incoming.map((tag) => tag.toLowerCase()));
+    next = current.filter((tag) => !drop.has(tag.toLowerCase()));
+  } else {
+    next = incoming;
+  }
+  const targets = siblings.length > 0 ? siblings : [thread];
+  let updated = thread;
+  for (const row of targets) {
+    const written = updateThread(row.id, { tags: next });
+    if (written.id === thread.id) updated = written;
+  }
+  return updated;
+}
+
 // src/threads/create.ts
 function persistCreateAttachments(worktreePath, attachments) {
   return persistPendingFileAttachments(worktreePath, attachments ?? []);
@@ -2318,20 +2413,26 @@ function reuseLiveThread(input, repoPath, match) {
     liveThreadsForCreate()
   );
   if (!existing) return void 0;
-  const thread = readThread(existing.id) ?? existing;
-  if (!input.attachments?.length) return thread;
-  return updateThread(thread.id, {
-    attachments: persistCreateAttachments(thread.worktreePath, [
-      ...thread.attachments,
-      ...input.attachments
-    ])
-  });
+  let thread = readThread(existing.id) ?? existing;
+  if (input.attachments?.length) {
+    thread = updateThread(thread.id, {
+      attachments: persistCreateAttachments(thread.worktreePath, [
+        ...thread.attachments,
+        ...input.attachments
+      ])
+    });
+  }
+  if (normalizeWorkspaceTags(input.tags).length > 0) {
+    thread = applyWorkspaceTags(thread.id, input.tags, "add");
+  }
+  return thread;
 }
 async function createThread(input, _onSetupLine) {
   const repoPath = await resolveRepoRoot(input.repoPath);
   if (!existsSync5(repoPath)) {
     throw new Error(`Repo not found: ${repoPath}`);
   }
+  if (isRemovedWorkspace(repoPath)) throw new Error(`Project was removed: ${repoPath}`);
   const reused = reuseLiveThread(input, repoPath, {
     sourceType: input.sourceType,
     sourceRef: input.sourceRef,
@@ -2390,7 +2491,8 @@ async function createThread(input, _onSetupLine) {
       sourceIsFork: false,
       parentThreadId: input.parentThreadId ?? null,
       status: "idle",
-      cowboy: true
+      cowboy: true,
+      tags: input.tags
     });
     writeThread(thread2);
     await ensureWorkspace(repoPath);
@@ -2404,7 +2506,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-VCVPSLSU.js");
+      const { ensureAbleTimeTask, issueAttachmentForAbleTimeTask } = await import("./abletime-WLDBJJUI.js");
       const task = await ensureAbleTimeTask({
         title: title?.trim() || "Untitled work",
         description: input.prompt?.trim() || void 0
@@ -2507,7 +2609,8 @@ async function createThread(input, _onSetupLine) {
     prTitle,
     prAuthorLogin: prAuthorLogin2,
     prLabels,
-    prIsDraft
+    prIsDraft,
+    tags: input.tags
   });
   writeThread(thread);
   await ensureWorkspace(repoPath);
@@ -2594,8 +2697,8 @@ function summarizeTurnLive(parts) {
   const interesting = [...tools].reverse().find((t) => !isPollWrapperToolName(t.name)) ?? lastTool;
   const lastToolLabel = interesting ? interesting.description || toolDescription(interesting.name, interesting.input) || interesting.name : void 0;
   const thinking = lastText(parts, "thinking");
-  const text = lastText(parts, "text");
-  const excerptRaw = thinking || text;
+  const text3 = lastText(parts, "text");
+  const excerptRaw = thinking || text3;
   const excerpt = excerptRaw.length > 280 ? `${excerptRaw.slice(-280)}` : excerptRaw || void 0;
   const summary = liveActivitySummary(parts);
   return {
@@ -2741,7 +2844,8 @@ async function forkThreadWorktree(input, onSetupLine) {
       title: input.title?.trim() || void 0,
       parentThreadId: from.id,
       attachments: [attachment],
-      reuseExisting: false
+      reuseExisting: false,
+      tags: from.tags
     },
     onSetupLine
   );
@@ -2749,7 +2853,7 @@ async function forkThreadWorktree(input, onSetupLine) {
 }
 
 // src/orchestrator/quota-failover.ts
-import { randomUUID } from "crypto";
+import { randomUUID as randomUUID2 } from "crypto";
 function managedKindForAgent(agent) {
   return agent === "claude" || agent === "codex" ? agent : null;
 }
@@ -2835,8 +2939,8 @@ function buildQuotaHandoffAttachment(from, limitText, fallbackAgent) {
   );
   const recent = from.messages.slice(-8).map((m) => {
     const role = m.role === "user" ? "User" : m.role === "agent" ? "Agent" : "Summary";
-    const text = m.text.trim().replace(/\s+/g, " ").slice(0, 280);
-    return text ? `- ${role}: ${text}` : null;
+    const text3 = m.text.trim().replace(/\s+/g, " ").slice(0, 280);
+    return text3 ? `- ${role}: ${text3}` : null;
   }).filter(Boolean);
   const orch = isOrchestratorThread(from);
   const instructions = orch ? [
@@ -2869,7 +2973,7 @@ function buildQuotaHandoffAttachment(from, limitText, fallbackAgent) {
     ...instructions
   ].join("\n");
   return {
-    id: randomUUID(),
+    id: randomUUID2(),
     name: orch ? "Orchestration quota handoff.md" : "Quota handoff.md",
     kind: "transcript",
     content: body
@@ -2964,13 +3068,13 @@ function resolveConductorCursorAgentId(workspacePath) {
   for (const hash of hashes) {
     const agentsFile = join7(CURSOR_SDK_STORE, hash, "agents.ndjson");
     if (!existsSync7(agentsFile)) continue;
-    let text;
+    let text3;
     try {
-      text = readFileSync5(agentsFile, "utf8");
+      text3 = readFileSync5(agentsFile, "utf8");
     } catch {
       continue;
     }
-    for (const line of text.split("\n")) {
+    for (const line of text3.split("\n")) {
       const trimmed = line.trim();
       if (!trimmed) continue;
       try {
@@ -3009,8 +3113,8 @@ async function adoptThread(input) {
     messages: input.messages ?? []
   });
   writeThread(thread);
-  const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-WU2RNLDV.js");
-  await ensureWorkspace2(repoPath);
+  const { addWorkspace: addWorkspace2 } = await import("./workspaces-F76BWCSI.js");
+  await addWorkspace2(repoPath);
   const { ensureWorktreeSideboardIgnored } = await import("./worktree-exclude-5N2KTYIT.js");
   await ensureWorktreeSideboardIgnored(input.worktreePath);
   return thread;
@@ -3736,13 +3840,13 @@ function formatStat(files) {
   return `${n} file${n === 1 ? "" : "s"} changed, ${additions} insertions(+), ${deletions} deletions(-)`;
 }
 function emptyScopeStats() {
-  const z = emptyStat();
+  const z4 = emptyStat();
   return {
-    commits: z,
-    uncommitted: z,
-    staged: z,
-    unstaged: z,
-    last_turn: z
+    commits: z4,
+    uncommitted: z4,
+    staged: z4,
+    unstaged: z4,
+    last_turn: z4
   };
 }
 function filesFromDiff(nameStatus, numstat, combinedDiff, maxHunk) {
@@ -4443,10 +4547,49 @@ async function confirmLand(thread, opts) {
   }
 }
 
+// src/diff/read-worktree-tail.ts
+import { closeSync, fstatSync, openSync, readSync } from "fs";
+import { join as join9 } from "path";
+var WORKTREE_TAIL_BYTES = 2e5;
+function readWorktreeFileTail(worktreePath, relativePath, maxBytes = WORKTREE_TAIL_BYTES) {
+  if (!relativePath || relativePath.includes("..") || relativePath.startsWith("/")) {
+    throw new Error("Invalid path");
+  }
+  const abs = join9(worktreePath, relativePath);
+  const fd = openSync(abs, "r");
+  try {
+    const st = fstatSync(fd);
+    if (!st.isFile()) throw new Error(`Not a file: ${relativePath}`);
+    const size = st.size;
+    const start = Math.max(0, size - maxBytes);
+    const length = size - start;
+    const buf = Buffer.alloc(length);
+    if (length > 0) readSync(fd, buf, 0, length, start);
+    if (buf.subarray(0, Math.min(buf.length, 8e3)).includes(0)) {
+      return {
+        path: relativePath,
+        content: `(binary file, ${size} bytes)`,
+        truncated: false,
+        binary: true,
+        encoding: "utf8"
+      };
+    }
+    let content = buf.toString("utf8");
+    const truncated = start > 0;
+    if (truncated) {
+      const nl = content.indexOf("\n");
+      if (nl >= 0) content = content.slice(nl + 1);
+    }
+    return { path: relativePath, content, truncated, binary: false, encoding: "utf8" };
+  } finally {
+    closeSync(fd);
+  }
+}
+
 // src/skills/discover.ts
 import { existsSync as existsSync10, readdirSync as readdirSync3, readFileSync as readFileSync7, statSync as statSync3 } from "fs";
 import { homedir } from "os";
-import { join as join9 } from "path";
+import { join as join10 } from "path";
 
 // src/skills/bundled/long-running.ts
 var LONG_RUNNING_SKILL_COMMAND = "long-running";
@@ -4615,7 +4758,7 @@ function scanSkillsDir(dir, source, out) {
   }
   for (const entry of entries) {
     if (entry.startsWith(".")) continue;
-    const skillMd = join9(dir, entry, "SKILL.md");
+    const skillMd = join10(dir, entry, "SKILL.md");
     if (!existsSync10(skillMd)) continue;
     try {
       if (!statSync3(skillMd).isFile()) continue;
@@ -4637,12 +4780,12 @@ function scanClaudePluginSkills(pluginsRoot, out) {
       return;
     }
     if (lookingForSkillsDir && entries.includes("SKILL.md")) {
-      const skill = readSkill(join9(dir, "SKILL.md"), "cli");
+      const skill = readSkill(join10(dir, "SKILL.md"), "cli");
       if (skill) out.push(skill);
     }
     for (const entry of entries) {
       if (entry === "node_modules" || entry === ".git") continue;
-      const full = join9(dir, entry);
+      const full = join10(dir, entry);
       try {
         if (!statSync3(full).isDirectory()) continue;
       } catch {
@@ -4662,17 +4805,17 @@ function discoverSkills(worktreePath) {
   const home = homedir();
   const collected = [];
   for (const rel of [".claude/skills", ".cursor/skills", ".sideboard/skills", ".brightsy/skills", "skills"]) {
-    scanSkillsDir(join9(worktreePath, rel), "workspace", collected);
+    scanSkillsDir(join10(worktreePath, rel), "workspace", collected);
   }
   for (const abs of [
-    join9(home, ".claude/skills"),
-    join9(home, ".cursor/skills"),
-    join9(home, ".sideboard/skills"),
-    join9(home, ".brightsy/skills")
+    join10(home, ".claude/skills"),
+    join10(home, ".cursor/skills"),
+    join10(home, ".sideboard/skills"),
+    join10(home, ".brightsy/skills")
   ]) {
     scanSkillsDir(abs, "user", collected);
   }
-  scanClaudePluginSkills(join9(home, ".claude/plugins"), collected);
+  scanClaudePluginSkills(join10(home, ".claude/plugins"), collected);
   collected.push(...bundledSkills());
   const rank = {
     workspace: 0,
@@ -4844,11 +4987,11 @@ function shiftQueuedItem(queue, queueAttachments) {
 
 // src/agents/instructions.ts
 import { existsSync as existsSync12 } from "fs";
-import { join as join11 } from "path";
+import { join as join12 } from "path";
 
 // src/skills/detached-job-path.ts
 import { existsSync as existsSync11 } from "fs";
-import { dirname as dirname2, join as join10 } from "path";
+import { dirname as dirname2, join as join11 } from "path";
 import { fileURLToPath } from "url";
 var DETACHED_JOB_FILENAMES = ["detached-job.cjs", "detached-job.js"];
 function compiledModuleDir() {
@@ -4865,7 +5008,7 @@ function compiledModuleDir() {
 }
 function detachedJobScriptIn(dir) {
   for (const name of DETACHED_JOB_FILENAMES) {
-    const script = join10(dir, "scripts", name);
+    const script = join11(dir, "scripts", name);
     if (existsSync11(script)) return script;
   }
   return null;
@@ -5002,12 +5145,15 @@ function formatWorktreeDirective(thread, opts) {
   lines.push(
     "Schedules: `create_schedule` / `list_schedules` (`at` / `every` / `cron`). `chatId=self` continues this chat; omit chatId for a new Global chat. Fires only while Sideboard.app is running. A future job turns on Settings \u2192 Advanced \u2192 Caffeinate while schedules are enabled."
   );
+  lines.push(
+    "`set_workspace_tags` labels this checkout (omit ref; replace, add, or remove). Not another checkout."
+  );
   lines.push("");
   lines.push(formatProcessGuideDirective({ worktreePath: thread.worktreePath }));
   return lines.join("\n");
 }
 function formatWorktreeReminder() {
-  return "Sideboard workspace: stay in this cwd for all file and git work. Push and open PRs against origin, never upstream. Do not edit the main repo checkout. If a goal is given (Greptile 5/5, CI green), watch-fix-push until it lands \u2014 do not watch after every push. Schedules: create_schedule (at / every / cron; chatId=self for this chat).";
+  return "Sideboard workspace: stay in this cwd for all file and git work. Push and open PRs against origin, never upstream. Do not edit the main repo checkout. If a goal is given (Greptile 5/5, CI green), watch-fix-push until it lands \u2014 do not watch after every push. Schedules: create_schedule (at / every / cron; chatId=self for this chat). set_workspace_tags updates labels on this workspace (omit ref).";
 }
 var PR_GOAL_RE = /greptile|\bci\b.*\b(green|pass)|checks?\s+(pass|green)|until\s+.*\b(pass|green|merge|clean)|\bfix ci\b|watch[- ]fix[- ]push/i;
 function mentionsPrGoal(prompt) {
@@ -5036,17 +5182,17 @@ function formatIssueToolsDirective(opts) {
   ];
   if (opts.linear) {
     lines.push(
-      "- Linear: `linear_search_issues` (assignee=me; pass `updatedSince` for \u201Cany updates since yesterday?\u201D \u2014 new tickets, edits, and comments), `linear_get_issue` (comments, attachments; pass `include=full` if crush.truncated), `linear_download_attachment` (saves to `.context/attachments/`), `linear_comment`, `linear_update_issue` (state, cycle, labels, project, parent, relations), `linear_create_issue` (pass `parent` for spin-offs; call `linear_list_teams` first). Scope errors: reconnect Linear in Settings \u2192 Issues."
+      "- Linear: `linear_search_issues` (assignee=me; pass `updatedSince` for \u201Cany updates since yesterday?\u201D \u2014 new tickets, edits, and comments; rows include the project), `linear_list_projects` (id, name, slug \u2014 use on update), `linear_get_issue` (comments, project, attachments; pass `include=full` if crush.truncated), `linear_download_attachment` (saves to `.context/attachments/`), `linear_comment`, `linear_update_issue` (state, cycle, labels, project, parent, relations), `linear_create_issue` (pass `parent` for spin-offs; call `linear_list_teams` first). Scope errors: reconnect Linear in Settings \u2192 Issues."
     );
   }
   if (github) {
     lines.push(
-      "- GitHub: `github_search_issues` (assignee=me; `updatedSince` for inbox updates + comments), `github_get_issue` (comments, attachments; pass `include=full` if crush.truncated), `github_download_attachment` (saves to `.context/attachments/`), `github_comment`, `github_update_issue` (state open|closed, labels, project, parent, relations), `github_create_issue` (pass `parent` for spin-offs). Uses Account `gh`."
+      "- GitHub: `github_search_issues` (assignee=me; `updatedSince` for inbox updates + comments; rows include projects when `gh` can read them), `github_list_projects` (titles for update), `github_get_issue` (comments, projects, attachments; pass `include=full` if crush.truncated; `projectsError` means run `gh auth refresh -s read:project`), `github_download_attachment` (saves to `.context/attachments/`), `github_comment`, `github_update_issue` (state open|closed, labels, project, parent, relations), `github_create_issue` (pass `parent` for spin-offs). Uses Account `gh`."
     );
   }
   if (opts.abletime) {
     lines.push(
-      "- AbleTime: `abletime_list_tasks` / `abletime_search_tasks` (`updatedSince` for inbox updates + comments), `abletime_get_task` (comments, attachments; pass `include=full` if crush.truncated), `abletime_download_attachment` (saves to `.context/attachments/`), `abletime_comment`, `abletime_update_task` (state, labels, project, parent, relations), `abletime_create_task` (pass `parent` for spin-offs; `abletime_list_projects` if needed)."
+      "- AbleTime: `abletime_list_tasks` / `abletime_search_tasks` (`updatedSince` for inbox updates + comments; rows include the project), `abletime_get_task` (comments, project, attachments; pass `include=full` if crush.truncated), `abletime_download_attachment` (saves to `.context/attachments/`), `abletime_comment`, `abletime_update_task` (state, labels, project, parent, relations), `abletime_create_task` (pass `parent` for spin-offs; `abletime_list_projects` if needed)."
     );
   }
   lines.push(
@@ -5084,9 +5230,9 @@ function formatPrGateDirective() {
 }
 function formatProcessGuideDirective(opts) {
   const worktree = opts?.worktreePath?.trim();
-  const hasGraphSkill = !!worktree && existsSync12(join11(worktree, ".claude/skills/graph-engineering/SKILL.md"));
-  const hasReviewSkill = !!worktree && existsSync12(join11(worktree, ".claude/skills/review/SKILL.md"));
-  const hasInstallSkill = !!worktree && existsSync12(join11(worktree, ".claude/skills/worktree-install/SKILL.md"));
+  const hasGraphSkill = !!worktree && existsSync12(join12(worktree, ".claude/skills/graph-engineering/SKILL.md"));
+  const hasReviewSkill = !!worktree && existsSync12(join12(worktree, ".claude/skills/review/SKILL.md"));
+  const hasInstallSkill = !!worktree && existsSync12(join12(worktree, ".claude/skills/worktree-install/SKILL.md"));
   return [
     "Process guides (recurring work only):",
     hasGraphSkill ? "- Migrations, ports, batch fixes, and other fan-out: follow `.claude/skills/graph-engineering/SKILL.md` (`/graph-engineering`). Judge first; state on disk; grow the rulebook; do not patch around it." : null,
@@ -5201,6 +5347,9 @@ function formatOptionalServicesDirective(integrations) {
       );
     }
   }
+  lines.push(
+    "If a connector MCP is listed but needsAuth or returns unauthorized, do not sign in to that MCP. Check the native CLI (or the HTTP API when there is no CLI) \u2014 the token is already in this process."
+  );
   lines.push(
     "If a CLI is missing, say so or use the HTTP API with the same token. The user can Install CLI from Settings \u2192 Connectors. Do not ask the user to install a vendor MCP."
   );
@@ -5226,7 +5375,451 @@ function formatOptionalServicesDirective(integrations) {
 }
 function formatOptionalServicesReminder(integrations) {
   if (connectedOptionalServices(integrations).length === 0) return null;
-  return "Settings \u2192 Connectors: official CLIs / PostHog HTTP with injected env. Write output to `.context/cli/` (not `.context/attachments/`) and read a slice \u2014 never dump raw --json/--expand into the tool result (any agent). stop_job if a fetch hangs. Do not add vendor MCPs.";
+  return "Settings \u2192 Connectors: official CLIs / PostHog HTTP with injected env. If a connector MCP needsAuth or is unauthorized, check the native CLI or HTTP API instead of signing in. Write output to `.context/cli/` (not `.context/attachments/`) and read a slice \u2014 never dump raw --json/--expand into the tool result (any agent). stop_job if a fetch hangs. Do not add vendor MCPs.";
+}
+
+// src/mcp/viewer-context-tools.ts
+import { z as z3 } from "zod";
+
+// src/mcp/env-tools.ts
+import { z as z2 } from "zod";
+
+// src/mcp/issue-list.ts
+import { z } from "zod";
+
+// src/integrations/issue-since.ts
+var ISSUE_SINCE_ERROR = "updatedSince must be an ISO datetime, YYYY-MM-DD, or relative time (yesterday, 2d, 3 hours ago)";
+var DATE_ONLY_RE = /^(\d{4})-(\d{2})-(\d{2})$/;
+var DATE_TIME_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}/;
+var RELATIVE_RE = /^(\d+)\s*(hours?|hrs?|h|days?|d|weeks?|wks?|w)(?:\s+ago)?$/i;
+function startOfLocalDay(date) {
+  return new Date(date.getFullYear(), date.getMonth(), date.getDate());
+}
+function addLocalDays(date, days) {
+  return new Date(date.getFullYear(), date.getMonth(), date.getDate() + days);
+}
+function parseIssueSince(input, now = /* @__PURE__ */ new Date()) {
+  const raw = input.trim();
+  if (!raw) throw new Error(ISSUE_SINCE_ERROR);
+  const dateOnly = raw.match(DATE_ONLY_RE);
+  if (dateOnly) {
+    const year = Number(dateOnly[1]);
+    const month = Number(dateOnly[2]);
+    const day = Number(dateOnly[3]);
+    const local = new Date(year, month - 1, day);
+    if (local.getFullYear() !== year || local.getMonth() !== month - 1 || local.getDate() !== day) {
+      throw new Error(ISSUE_SINCE_ERROR);
+    }
+    return startOfLocalDay(local).toISOString();
+  }
+  if (DATE_TIME_RE.test(raw)) {
+    const ms = Date.parse(raw);
+    if (!Number.isFinite(ms)) throw new Error(ISSUE_SINCE_ERROR);
+    return new Date(ms).toISOString();
+  }
+  const lower = raw.toLowerCase();
+  if (lower === "today") return startOfLocalDay(now).toISOString();
+  if (lower === "yesterday") return addLocalDays(startOfLocalDay(now), -1).toISOString();
+  if (lower === "last week" || lower === "lastweek") {
+    return addLocalDays(startOfLocalDay(now), -7).toISOString();
+  }
+  const relative = lower.match(RELATIVE_RE);
+  if (relative) {
+    const n = Number(relative[1]);
+    if (!Number.isInteger(n) || n < 1) throw new Error(ISSUE_SINCE_ERROR);
+    const unit = relative[2];
+    if (unit.startsWith("h")) return new Date(now.getTime() - n * 36e5).toISOString();
+    if (unit.startsWith("w")) return addLocalDays(startOfLocalDay(now), -7 * n).toISOString();
+    return addLocalDays(startOfLocalDay(now), -n).toISOString();
+  }
+  throw new Error(ISSUE_SINCE_ERROR);
+}
+function formatGitHubSearchUpdatedSince(iso) {
+  return iso.replace(/\.\d{3}Z$/, "Z");
+}
+function issueMatchesUpdatedSince(issue, sinceIso) {
+  const ts = issue.updatedAt || issue.createdAt;
+  if (!ts) return false;
+  const value = Date.parse(ts);
+  const since = Date.parse(sinceIso);
+  return Number.isFinite(value) && Number.isFinite(since) && value >= since;
+}
+var ISSUE_COMMENT_PREVIEW_CHARS = 240;
+function previewIssueCommentBody(body) {
+  const flat = body.replace(/\s+/g, " ").trim();
+  if (flat.length <= ISSUE_COMMENT_PREVIEW_CHARS) return flat;
+  return `${flat.slice(0, ISSUE_COMMENT_PREVIEW_CHARS - 1).trimEnd()}\u2026`;
+}
+function issueActivityKind(issue, sinceIso) {
+  const created = issue.createdAt ? Date.parse(issue.createdAt) : Number.NaN;
+  const since = Date.parse(sinceIso);
+  if (Number.isFinite(created) && Number.isFinite(since) && created >= since) return "created";
+  return "updated";
+}
+
+// src/mcp/issue-list.ts
+var MCP_ISSUE_LIST_DEFAULT_LIMIT = 40;
+var MCP_ISSUE_LIST_MAX_LIMIT = 250;
+function clampMcpIssueLimit(limit) {
+  if (limit == null || !Number.isFinite(limit)) return MCP_ISSUE_LIST_DEFAULT_LIMIT;
+  return Math.max(1, Math.min(MCP_ISSUE_LIST_MAX_LIMIT, Math.floor(limit)));
+}
+function applyIssueListWindow(items, limit) {
+  const truncated = items.length > limit;
+  return {
+    items: truncated ? items.slice(0, limit) : items,
+    truncated
+  };
+}
+var MCP_ISSUE_UPDATED_SINCE_DESCRIPTION = "ISO datetime, YYYY-MM-DD, or relative (yesterday, 2d, 3 hours ago). Tickets updated since then plus new comments. Use for \u201Cany updates since yesterday?\u201D";
+var mcpIssueUpdatedSinceSchema = z.string().min(1).optional().describe(MCP_ISSUE_UPDATED_SINCE_DESCRIPTION);
+function compactIssueRow(issue, opts) {
+  const projectNames = (issue.projects ?? []).map((project) => (project.name || project.id || "").trim()).filter(Boolean);
+  return {
+    identifier: issue.identifier,
+    title: issue.title,
+    ...issue.assignee ? { assignee: issue.assignee } : {},
+    ...issue.labels.length > 0 ? { labels: issue.labels } : {},
+    ...issue.teamKey ? { team: issue.teamKey } : {},
+    ...issue.cycle?.name ? { cycle: issue.cycle.name } : {},
+    ...projectNames.length ? { projects: projectNames } : {},
+    ...issue.createdAt ? { createdAt: issue.createdAt } : {},
+    ...issue.updatedAt ? { updatedAt: issue.updatedAt } : {},
+    ...opts?.since ? { kind: issueActivityKind(issue, opts.since) } : {}
+  };
+}
+function formatMcpIssueList(input) {
+  const truncated = input.truncated || Boolean(input.commentsTruncated);
+  const comments = input.comments ?? [];
+  return {
+    ...input.source ? { source: input.source } : {},
+    ...input.viewer ? { viewer: input.viewer } : {},
+    limit: input.limit,
+    returned: input.issues.length,
+    truncated,
+    ...input.since ? { since: input.since } : {},
+    ...truncated ? {
+      hint: input.since ? "More issues or comments match. Pass a higher limit (max 250) or a tighter query." : "More issues match. Pass a higher limit (max 250) or a tighter query."
+    } : {},
+    issues: input.issues.map((issue) => compactIssueRow(issue, { since: input.since })),
+    ...input.since || comments.length > 0 ? { comments } : {}
+  };
+}
+function formatListedIssuesForMcp(result, page) {
+  const windowed = applyIssueListWindow(result.issues, page);
+  const comments = result.comments ?? [];
+  const commentWindow = applyIssueListWindow(comments, page);
+  return formatMcpIssueList({
+    source: result.source,
+    viewer: result.viewer?.name || result.viewer?.login,
+    limit: page,
+    issues: windowed.items,
+    truncated: windowed.truncated,
+    since: result.since,
+    comments: commentWindow.items,
+    commentsTruncated: commentWindow.truncated
+  });
+}
+function mcpJson(payload, isError = false) {
+  return {
+    content: [{ type: "text", text: JSON.stringify(payload) }],
+    ...isError ? { isError: true } : {}
+  };
+}
+
+// src/mcp/env-tools.ts
+function text(payload, isError = false) {
+  return mcpJson(payload, isError);
+}
+var PROJECT_PATH_HINT = "Pass repoPath from list_projects. Orchestration cwd is synthetic \u2014 do not omit repoPath for scope=project. Worktree turns may omit it (uses cwd).";
+async function projectFor(repoPath) {
+  const hint = repoPath?.trim() || process.cwd();
+  const name = projectNameForRepoPath(hint);
+  if (!name) return null;
+  return { name, prefix: projectEnvPrefix(name) };
+}
+function registerEnvTools(server) {
+  server.tool(
+    "list_env",
+    "List Settings \u2192 Environment variable names (not values). scope=project keys use the project prefix (project name, uppercased, plus _). scope=account keys are shared by every project. Pass repoPath from list_projects when calling from orchestration so the reply includes this project prefix.",
+    {
+      repoPath: z2.string().optional().describe(
+        "Registered workspace or worktree path. Required from orchestration. Omit on a worktree turn (uses cwd)."
+      )
+    },
+    async ({ repoPath }) => {
+      try {
+        const project = await projectFor(repoPath);
+        return text({
+          project: project?.name ?? null,
+          prefix: project?.prefix ?? null,
+          keys: listEnvKeys()
+        });
+      } catch (err) {
+        return text({ error: err instanceof Error ? err.message : String(err) }, true);
+      }
+    }
+  );
+  server.tool(
+    "set_env",
+    "Set a Settings \u2192 Environment variable. scope=project prefixes the key with the project name (APPLE_ID on project sideboard is stored as SIDEBOARD_APPLE_ID). scope=account stores the key unchanged and is shared by every project. Values are injected into later agent turns. list_env does not return values.",
+    {
+      key: z2.string().describe("Env name. For scope=project, pass the bare name or the already-prefixed name."),
+      value: z2.string().describe("Value to store. Empty deletes the key."),
+      scope: z2.enum(["account", "project"]).describe("project = prefixed for one repo; account = shared by every project"),
+      repoPath: z2.string().optional().describe(
+        "Required for scope=project from orchestration (path from list_projects). Worktree turns may omit it (cwd)."
+      )
+    },
+    async ({ key, value, scope, repoPath }) => {
+      try {
+        const envScope = scope;
+        if (envScope === "project") {
+          const project = await projectFor(repoPath);
+          if (!project) return text({ ok: false, error: "repoPath required", message: PROJECT_PATH_HINT }, true);
+          const saved2 = setEnvVar({
+            key,
+            value,
+            scope: "project",
+            projectName: project.name
+          });
+          return text({ ok: true, ...saved2 });
+        }
+        const saved = setEnvVar({ key, value, scope: "account" });
+        return text({ ok: true, ...saved });
+      } catch (err) {
+        return text({ error: err instanceof Error ? err.message : String(err) }, true);
+      }
+    }
+  );
+  server.tool(
+    "delete_env",
+    "Delete a Settings \u2192 Environment variable. scope=project uses the project prefix (same rule as set_env). Does not print the stored value.",
+    {
+      key: z2.string().describe("Env name. For scope=project, pass the bare name or the already-prefixed name."),
+      scope: z2.enum(["account", "project"]),
+      repoPath: z2.string().optional().describe(
+        "Required for scope=project from orchestration (path from list_projects). Worktree turns may omit it (cwd)."
+      )
+    },
+    async ({ key, scope, repoPath }) => {
+      try {
+        const envScope = scope;
+        if (envScope === "project") {
+          const project = await projectFor(repoPath);
+          if (!project) return text({ ok: false, error: "repoPath required", message: PROJECT_PATH_HINT }, true);
+          const removed2 = deleteEnvVar({
+            key,
+            scope: "project",
+            projectName: project.name
+          });
+          return text({ ok: true, ...removed2 });
+        }
+        const removed = deleteEnvVar({ key, scope: "account" });
+        return text({ ok: true, ...removed });
+      } catch (err) {
+        return text({ error: err instanceof Error ? err.message : String(err) }, true);
+      }
+    }
+  );
+}
+
+// src/mcp/viewer-context-tools.ts
+function text2(payload, isError = false) {
+  return mcpJson(payload, isError);
+}
+function matchRegisteredWorkspace(repoPath) {
+  const hint = (repoPath ?? "").trim().replace(/\/+$/, "");
+  if (!hint) return null;
+  let best = null;
+  for (const w of listWorkspaces()) {
+    const stored = w.path.replace(/\/+$/, "");
+    if (stored === hint || hint.startsWith(`${stored}/`)) {
+      if (!best || stored.length > best.length) best = stored;
+    }
+  }
+  return best;
+}
+async function resolveProjectRepoPath(repoPath) {
+  const hint = repoPath?.trim() || process.cwd();
+  let root = hint;
+  try {
+    root = await resolveRepoRoot(hint);
+  } catch {
+    root = hint.replace(/\/+$/, "");
+  }
+  return matchRegisteredWorkspace(root) ?? matchRegisteredWorkspace(hint);
+}
+var PROJECT_PATH_HINT2 = "Pass repoPath from list_projects. Orchestration cwd is synthetic and empty \u2014 do not omit repoPath for project context.";
+function registerViewerContextTools(server) {
+  server.tool(
+    "get_viewer_context",
+    "Read account and project user context (Settings \u2192 Agents / Projects): roles, tickets, and review queues as freeform text. Orchestration must pass repoPath from list_projects for project context. Worktree turns may omit repoPath (uses cwd).",
+    {
+      repoPath: z3.string().optional().describe(
+        "Registered workspace or worktree path. Required from orchestration for a project. Omit on a worktree turn (uses cwd)."
+      )
+    },
+    async ({ repoPath }) => {
+      try {
+        const path = await resolveProjectRepoPath(repoPath);
+        return text2(readViewerContext(path ?? void 0));
+      } catch (err) {
+        return text2(
+          { error: err instanceof Error ? err.message : String(err) },
+          true
+        );
+      }
+    }
+  );
+  server.tool(
+    "update_viewer_context",
+    "Replace account or project user context (Settings \u2192 Agents / Projects). Never call until the user confirmed. Show the proposed text, ask_user (Save this context / Do not save), wait, then pass confirmed=true. Empty context clears that field.",
+    {
+      scope: z3.enum(["account", "project"]).describe("account = Settings \u2192 Agents; project = Settings \u2192 Projects for one repo"),
+      context: z3.string().describe("Full replacement text (roles, tickets, review queues). Empty clears."),
+      confirmed: z3.boolean().optional().describe("Must be true after the user confirmed via ask_user. False/omit is rejected."),
+      repoPath: z3.string().optional().describe(
+        "Required for scope=project from orchestration (path from list_projects). Worktree turns may omit it (cwd)."
+      )
+    },
+    async ({ scope, context, confirmed, repoPath }) => {
+      try {
+        if (scope === "project") {
+          const path = await resolveProjectRepoPath(repoPath);
+          if (!path) {
+            return text2(
+              {
+                ok: false,
+                error: "repoPath required",
+                message: PROJECT_PATH_HINT2
+              },
+              true
+            );
+          }
+          const result2 = writeViewerContext({
+            scope,
+            context,
+            repoPath: path,
+            confirmed: confirmed === true
+          });
+          return text2(result2, !result2.ok);
+        }
+        const result = writeViewerContext({
+          scope,
+          context,
+          confirmed: confirmed === true
+        });
+        return text2(result, !result.ok);
+      } catch (err) {
+        return text2(
+          { error: err instanceof Error ? err.message : String(err) },
+          true
+        );
+      }
+    }
+  );
+  registerEnvTools(server);
+}
+
+// src/store/env-vars.ts
+var ENV_KEY = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function projectEnvPrefix(projectName) {
+  const slug = projectName.normalize("NFKD").replace(/[^A-Za-z0-9]+/g, "_").replace(/_+/g, "_").replace(/^_|_$/g, "").toUpperCase().slice(0, 40);
+  return `${slug || "PROJECT"}_`;
+}
+function assertEnvKey(key) {
+  const k = key.trim();
+  if (!ENV_KEY.test(k)) {
+    throw new Error(
+      `Invalid env key "${key}". Use letters, digits, and underscores, starting with a letter or underscore.`
+    );
+  }
+  return k;
+}
+function qualifyProjectEnvKey(prefix, key) {
+  const k = assertEnvKey(key);
+  if (k.toUpperCase().startsWith(prefix)) return prefix + k.slice(prefix.length);
+  return prefix + k;
+}
+function projectNameForRepoPath(repoPath) {
+  const matched = matchRegisteredWorkspace(repoPath);
+  if (!matched) return null;
+  const found = listWorkspaces().find((w) => w.path.replace(/\/+$/, "") === matched);
+  return found?.name?.trim() || null;
+}
+function projectPrefixes() {
+  return listWorkspaces().map((w) => ({ name: w.name.trim(), prefix: projectEnvPrefix(w.name) })).filter((p) => p.name && p.prefix !== "PROJECT_").sort((a, b) => b.prefix.length - a.prefix.length);
+}
+function classifyEnvKey(key) {
+  const hit = projectPrefixes().find((p) => key.startsWith(p.prefix));
+  if (!hit) return { scope: "account" };
+  return { scope: "project", project: hit.name, prefix: hit.prefix };
+}
+function listEnvKeys() {
+  return Object.keys(loadAppSettings().environment).sort((a, b) => a.localeCompare(b)).map((key) => ({ key, ...classifyEnvKey(key) }));
+}
+function setEnvVar(input) {
+  const value = input.value;
+  if (input.scope === "account") {
+    const key2 = assertEnvKey(input.key);
+    if (value.trim() === "") {
+      updateAppEnvironment({ [key2]: null });
+      return { key: key2, scope: "account" };
+    }
+    updateAppEnvironment({ [key2]: value });
+    return { key: key2, scope: "account" };
+  }
+  const project = input.projectName?.trim();
+  if (!project) throw new Error("Project name required for scope=project.");
+  const prefix = projectEnvPrefix(project);
+  const key = qualifyProjectEnvKey(prefix, input.key);
+  if (value.trim() === "") {
+    updateAppEnvironment({ [key]: null });
+  } else {
+    updateAppEnvironment({ [key]: value });
+  }
+  return { key, scope: "project", prefix, project };
+}
+function deleteEnvVar(input) {
+  const current = loadAppSettings().environment;
+  if (input.scope === "account") {
+    const key2 = assertEnvKey(input.key);
+    const deleted2 = Object.prototype.hasOwnProperty.call(current, key2);
+    updateAppEnvironment({ [key2]: null });
+    return { key: key2, scope: "account", deleted: deleted2 };
+  }
+  const project = input.projectName?.trim();
+  if (!project) throw new Error("Project name required for scope=project.");
+  const prefix = projectEnvPrefix(project);
+  const key = qualifyProjectEnvKey(prefix, input.key);
+  const deleted = Object.prototype.hasOwnProperty.call(current, key);
+  updateAppEnvironment({ [key]: null });
+  return { key, scope: "project", deleted, prefix, project };
+}
+function formatEnvDirective(projectName) {
+  if (!projectName) {
+    return [
+      "Sideboard environment (Settings \u2192 Environment): list_env, set_env, delete_env.",
+      "scope=project prefixes the key with the registered project name (uppercased, then _). APPLE_ID for a project named sideboard is stored as SIDEBOARD_APPLE_ID.",
+      "scope=account is shared by every project and is not prefixed.",
+      "list_env returns names only. A value is injected into later agent turns."
+    ].join(" ");
+  }
+  const prefix = projectEnvPrefix(projectName);
+  return [
+    "Sideboard environment (Settings \u2192 Environment): list_env, set_env, delete_env.",
+    `This project's prefix is ${prefix}. Project secrets must use that prefix \u2014 set_env scope=project applies it (APPLE_ID becomes ${prefix}APPLE_ID).`,
+    "scope=account is only for variables shared by every project.",
+    "list_env returns names only. A value set here is injected into later agent turns."
+  ].join(" ");
+}
+function formatEnvReminder(projectName) {
+  if (!projectName) {
+    return "Sideboard env: list_env / set_env / delete_env. scope=project prefixes the key with the project name (SIDEBOARD_APPLE_ID). scope=account is shared by every project.";
+  }
+  const prefix = projectEnvPrefix(projectName);
+  return `Sideboard env: list_env / set_env / delete_env. This project's prefix is ${prefix}. scope=project stores ${prefix}<NAME>. scope=account is shared by every project.`;
 }
 
 // src/threads/sync-branch.ts
@@ -5250,9 +5843,9 @@ async function syncThreadBranchFromGit(threadId) {
 }
 
 // src/store/schedules.ts
-import { randomUUID as randomUUID2 } from "crypto";
+import { randomUUID as randomUUID3 } from "crypto";
 import { existsSync as existsSync13, readFileSync as readFileSync8 } from "fs";
-import { join as join12 } from "path";
+import { join as join13 } from "path";
 import { Cron } from "croner";
 var DURATION_RE = /^(\d+)(s|m|h|d)$/i;
 var UNIT_MS = {
@@ -5262,7 +5855,7 @@ var UNIT_MS = {
   d: 864e5
 };
 function schedulesPath() {
-  return join12(appDataDir(), "schedules.json");
+  return join13(appDataDir(), "schedules.json");
 }
 function parseDurationMs(every) {
   const m = every.trim().match(DURATION_RE);
@@ -5389,7 +5982,7 @@ function buildTask(input, now) {
   const ts = nowIso(now);
   const agent = input.agent ? coerceOrchestratorAgent(input.agent) : null;
   return {
-    id: randomUUID2(),
+    id: randomUUID3(),
     name: input.name?.trim() || defaultScheduleName(prompt),
     prompt,
     enabled: input.enabled !== false,
@@ -5500,7 +6093,7 @@ function formatScheduledPrompt(name, prompt) {
 ${prompt}`;
 }
 async function defaultDeps() {
-  const { getOrchestrator: getOrchestrator2, startOrchestration: startOrchestration2 } = await import("./orchestrator-E5WK57DA.js");
+  const { getOrchestrator: getOrchestrator2, startOrchestration: startOrchestration2 } = await import("./orchestrator-HWJHK5NL.js");
   const orch = getOrchestrator2();
   return {
     findThread: (id) => findThreadByRef(id),
@@ -5848,6 +6441,10 @@ var Orchestrator = class {
         }
         continue;
       }
+      if (thisProcessShouldDrainAgentQueues() && isUnclaimedSteerRequest(thread.steerRequest) && thread.queue.length > 0) {
+        this.finishSteer(thread.id, false);
+        continue;
+      }
       if (thread.queue.length > 0) {
         this.haltDrain.delete(thread.id);
         this.armDrain(thread.id);
@@ -6232,8 +6829,12 @@ var Orchestrator = class {
   async addWorkspace(repoPath) {
     return addWorkspace(repoPath);
   }
-  removeWorkspace(repoPath) {
+  async removeWorkspace(repoPath) {
     removeWorkspace(repoPath);
+    for (const thread of listThreads()) {
+      if (!sameWorkspacePath(thread.repoPath, repoPath)) continue;
+      await this.archive(thread.id).catch(() => void 0);
+    }
   }
   async adopt(input) {
     const thread = await adoptThread(input);
@@ -6306,11 +6907,11 @@ var Orchestrator = class {
     return results;
   }
   /** Edit the text of a not-yet-started queued message. */
-  async editQueuedMessage(threadRef, index, text) {
+  async editQueuedMessage(threadRef, index, text3) {
     const thread = this.requireThread(threadRef);
     return withThreadLock(thread.id, async () => {
       const current = this.requireThread(thread.id);
-      const trimmed = text.trim();
+      const trimmed = text3.trim();
       if (!trimmed || index < 0 || index >= current.queue.length) {
         return current;
       }
@@ -6344,33 +6945,37 @@ var Orchestrator = class {
       return next;
     });
   }
-  /**
-   * Promote a queued message to run next, interrupting the in-flight turn (if any).
-   * The current turn is stopped without clearing the rest of the queue — drainQueue
-   * picks the promoted message up as soon as the interrupted turn unwinds.
-   */
+  /** Promote a queued prompt to run next, interrupting the in-flight turn. */
   async sendQueuedMessageNow(threadRef, index) {
     const thread = this.requireThread(threadRef);
+    const handoff = !thisProcessShouldDrainAgentQueues();
     const promoted = await withThreadLock(thread.id, async () => {
-      const current2 = this.requireThread(thread.id);
-      if (index < 0 || index >= current2.queue.length) return false;
-      const next = moveQueuedItemToFront(current2.queue, current2.queueAttachments, index);
+      const current = this.requireThread(thread.id);
+      if (index < 0 || index >= current.queue.length) return false;
+      const next = moveQueuedItemToFront(current.queue, current.queueAttachments, index);
       this.haltDrain.delete(thread.id);
-      updateThread(thread.id, next);
+      updateThread(thread.id, {
+        ...next,
+        ...handoff ? { steerRequest: nextSteerRequest(current.steerRequest) } : {}
+      });
       this.emit({ type: "queue_changed", threadId: thread.id, queue: next.queue });
       return true;
     });
-    if (!promoted) return this.requireThread(thread.id);
-    if (!thisProcessShouldDrainAgentQueues()) return this.requireThread(thread.id);
-    const current = this.requireThread(thread.id);
-    const inFlight = this.activeTurns.has(thread.id) || this.startingTurns.has(thread.id);
-    const livePid = current.agentPid;
-    const foreignLive = !inFlight && typeof livePid === "number" && livePid > 0 && isPidAlive(livePid);
-    if (inFlight || foreignLive) {
-      this.stop(thread.id, { clearQueue: false, continueQueue: true });
+    if (!promoted || handoff) return this.requireThread(thread.id);
+    return this.finishSteer(thread.id);
+  }
+  /** Desktop host: interrupt the live turn and start the front-of-queue prompt. */
+  finishSteer(threadId, notifyParent = true) {
+    claimSteerRequest(threadId);
+    this.haltDrain.delete(threadId);
+    const current = this.requireThread(threadId);
+    const inFlight = this.activeTurns.has(threadId) || this.startingTurns.has(threadId);
+    const pid = current.agentPid;
+    if (inFlight || typeof pid === "number" && pid > 0 && isPidAlive(pid)) {
+      this.stop(threadId, { clearQueue: false, continueQueue: true, notifyParent });
     }
-    this.armDrain(thread.id);
-    return this.requireThread(thread.id);
+    this.armDrain(threadId);
+    return this.requireThread(threadId);
   }
   armDrain(threadId) {
     void this.drainQueue(threadId).catch((err) => {
@@ -6501,7 +7106,7 @@ var Orchestrator = class {
         orch: isOrchestratorThread(thread)
       });
       if (this.stoppedTurns.has(threadId)) {
-        const stopped = writeLiveStatus(threadId, "stopped");
+        const stopped = writeStoppedStatus(threadId);
         if (stopped?.status === "stopped") {
           this.emit({ type: "status_changed", threadId, status: "stopped" });
         }
@@ -6547,7 +7152,9 @@ var Orchestrator = class {
         ticketId: issueTicket?.id,
         ticketProvider: issueTicket?.provider
       }) : null;
-      const viewerContextReminder = thread.agent !== "brightsy" && !isOrchestratorThread(thread) ? formatViewerContextReminder() : null;
+      const viewerContextReminder = thread.agent !== "brightsy" && !isOrchestratorThread(thread) ? `${formatViewerContextReminder()}
+
+${formatEnvReminder(projectNameForRepoPath(thread.repoPath || thread.worktreePath))}` : null;
       const reviewWriteGateReminder = thread.agent !== "brightsy" && !isOrchestratorThread(thread) && isReviewWriteGatedThread(
         thread,
         thread.worktreePath ? threadsSharingWorktree(thread.worktreePath) : []
@@ -6621,16 +7228,15 @@ var Orchestrator = class {
         fresh.worktreePath ? threadsSharingWorktree(fresh.worktreePath) : []
       ) ? null : formatReviewWriteGateDirective();
       let viewerContextDirective = null;
+      let envDirective = null;
       if (!isBrightsy && !isOrchestration) {
+        const repo = fresh.repoPath || fresh.worktreePath;
         try {
-          viewerContextDirective = formatViewerContextDirective(
-            resolveViewerProfileForRepo(fresh.repoPath || fresh.worktreePath)
-          );
+          viewerContextDirective = formatViewerContextDirective(resolveViewerProfileForRepo(repo));
         } catch {
-          viewerContextDirective = formatViewerContextDirective(
-            resolveViewerProfileForRepo()
-          );
+          viewerContextDirective = formatViewerContextDirective(resolveViewerProfileForRepo());
         }
+        envDirective = formatEnvDirective(projectNameForRepoPath(repo));
       }
       const settings = loadWorkspaceSettings(fresh.worktreePath, fresh.repoPath);
       let renameBranchDirective = null;
@@ -6672,6 +7278,7 @@ var Orchestrator = class {
         issueToolsDirective,
         reviewWriteGateDirective,
         viewerContextDirective,
+        envDirective,
         artifactDirective,
         longRunningDirective,
         renameBranchDirective,
@@ -6801,6 +7408,7 @@ var Orchestrator = class {
           issueToolsDirective,
           reviewWriteGateDirective,
           viewerContextDirective,
+          envDirective,
           artifactDirective,
           longRunningDirective,
           renameBranchDirective,
@@ -6886,7 +7494,7 @@ var Orchestrator = class {
       }
       settleAgentBlock(threadId, parts, exitCode !== 0 && !this.stoppedTurns.has(threadId));
       if (this.stoppedTurns.has(threadId)) {
-        const stopped = writeLiveStatus(threadId, "stopped");
+        const stopped = writeStoppedStatus(threadId);
         if (stopped?.status === "stopped") {
           this.emit({ type: "status_changed", threadId, status: "stopped" });
         }
@@ -6937,7 +7545,7 @@ var Orchestrator = class {
       await syncThreadBranchFromGit(threadId).catch(() => void 0);
       settleAgentBlock(threadId, void 0, !this.stoppedTurns.has(threadId));
       if (this.stoppedTurns.has(threadId)) {
-        const stopped = writeLiveStatus(threadId, "stopped");
+        const stopped = writeStoppedStatus(threadId);
         if (stopped?.status === "stopped") {
           this.emit({ type: "status_changed", threadId, status: "stopped" });
         }
@@ -7018,7 +7626,7 @@ var Orchestrator = class {
       } catch {
       }
     }
-    const stopped = writeLiveStatus(thread.id, "stopped") ?? readThread(thread.id) ?? thread;
+    const stopped = writeStoppedStatus(thread.id, resolveStopReason(opts)) ?? readThread(thread.id) ?? thread;
     if (stopped.status === "stopped") {
       this.emit({ type: "status_changed", threadId: thread.id, status: "stopped" });
       if (inFlight && opts?.notifyParent !== false) {
@@ -7197,7 +7805,7 @@ var Orchestrator = class {
     const request = sameIntent ? pending : {
       op,
       scriptName: scriptName ?? null,
-      requestId: randomUUID3(),
+      requestId: randomUUID4(),
       requestedAt: (/* @__PURE__ */ new Date()).toISOString()
     };
     if (!sameIntent) {
@@ -7642,7 +8250,7 @@ var Orchestrator = class {
     const stillRunning = this.threadLooksLive(thread);
     const rawText = (lastAgent?.text ?? "").trim();
     const finishedText = (rawText && !isInternalAgentStatusText(rawText) ? rawText : "") || (thread.status === "error" || thread.status === "stopped" || thread.status === "broken" ? lastError ?? "" : "");
-    const text = stillRunning ? "" : finishedText;
+    const text3 = stillRunning ? "" : finishedText;
     const live = stillRunning ? readTurnLive(thread.id) : null;
     const liveSummary = live?.summary && !isInternalAgentStatusText(live.summary) ? live.summary : null;
     const queuedHint = stillRunning && thread.status === "queued" && !liveSummary ? "Queued \u2014 waiting for a concurrency slot" : null;
@@ -7653,7 +8261,7 @@ var Orchestrator = class {
     });
     const block = thread.agentBlock?.reason?.trim() ? thread.agentBlock : null;
     return {
-      text,
+      text: text3,
       status: thread.status,
       taskState,
       sessionId: thread.sessionId,
@@ -7728,12 +8336,12 @@ var Orchestrator = class {
       return "missing";
     }
   }
-  async readFile(threadRef, relativePath) {
+  async readFile(threadRef, relativePath, tail) {
     const thread = this.requireThread(threadRef);
     if (relativePath.includes("..") || relativePath.startsWith("/")) {
       throw new Error("Invalid path");
     }
-    return readWorktreeFile(thread.worktreePath, relativePath);
+    return (tail ? readWorktreeFileTail : readWorktreeFile)(thread.worktreePath, relativePath);
   }
   async readFileForUpload(threadRef, relativePath) {
     const thread = this.requireThread(threadRef);
@@ -8028,7 +8636,7 @@ var Orchestrator = class {
     return tab;
   }
   /**
-   * Desktop git buttons + MCP `ask_git`. Always queues the worktree agent
+   * Desktop git buttons + MCP `ask_git`. Always steers the worktree agent
    * with the action prompt (same path as Resolve). Repository `[prompts]`
    * overrides apply when set.
    */
@@ -8112,6 +8720,9 @@ var Orchestrator = class {
     if (!next) throw new Error("Title cannot be empty");
     return updateThread(thread.id, { title: next, userSetTitle: true });
   }
+  setWorkspaceTags(threadRef, tags) {
+    return applyWorkspaceTags(threadRef, tags, "replace");
+  }
   async switchThreadBranch(threadRef, branchName) {
     const thread = this.requireThread(threadRef);
     this.assertNotGlobal(thread, "Switch branch");
@@ -8193,11 +8804,7 @@ var Orchestrator = class {
     this.emit({ type: "status_changed", threadId: archived.id, status: "archived" });
     this.enforceHistoryRetention();
     if (thread.repoPath && !isGlobalRepoPath(thread.repoPath)) {
-      try {
-        const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-WU2RNLDV.js");
-        await ensureWorkspace2(thread.repoPath);
-      } catch {
-      }
+      await ensureWorkspace(thread.repoPath).catch(() => void 0);
     }
     return archived;
   }
@@ -8248,16 +8855,12 @@ var Orchestrator = class {
           `Cowboy checkout missing: ${thread.worktreePath}. Re-add the project folder, then restore.`
         );
       }
-      const { createThreadWorktree: createThreadWorktree2 } = await import("./worktree-L57T3KH7.js");
-      const slug = thread.worktreePath.split("/").pop();
       const dest = thread.worktreePath;
       await withRepoGitLock(thread.repoPath, async () => {
         await git(["worktree", "add", dest, thread.branchName], thread.repoPath);
       });
       const { ensureWorktreeSideboardIgnored } = await import("./worktree-exclude-5N2KTYIT.js");
       await ensureWorktreeSideboardIgnored(dest);
-      void createThreadWorktree2;
-      void slug;
     }
     const restorePatch = {};
     let alreadyMerged = normalizePrState(thread.prState) === "MERGED";
@@ -8281,6 +8884,9 @@ var Orchestrator = class {
     if (Object.keys(restorePatch).length > 0) {
       updateThread(thread.id, restorePatch);
     }
+    if (thread.repoPath && !isGlobalRepoPath(thread.repoPath)) {
+      await addWorkspace(thread.repoPath).catch(() => void 0);
+    }
     const restored = setStatus(thread.id, "idle");
     this.emit({ type: "status_changed", threadId: restored.id, status: restored.status });
     return restored;
@@ -8358,7 +8964,7 @@ async function startOrchestration(opts) {
     sourceRef: "default",
     ...createOpts
   }).catch(async () => {
-    const { resolveDefaultBranch: resolveDefaultBranch2, resolveRepoRoot: resolveRepoRoot2 } = await import("./worktree-L57T3KH7.js");
+    const { resolveDefaultBranch: resolveDefaultBranch2, resolveRepoRoot: resolveRepoRoot2 } = await import("./worktree-NKLNVNXX.js");
     const repo = await resolveRepoRoot2(repoPath);
     const def = await resolveDefaultBranch2(repo);
     return orch.createThread({
@@ -8368,7 +8974,7 @@ async function startOrchestration(opts) {
       repoPath: repo
     });
   });
-  const { updateThread: upd } = await import("./thread-store-B3ZM4QEZ.js");
+  const { updateThread: upd } = await import("./thread-store-7XBOUQ5K.js");
   const updated = upd(thread.id, {
     sourceType: "orchestration",
     sourceRef: goal
@@ -8405,8 +9011,20 @@ export {
   findBoardPr,
   assembleHomeBoard,
   HOME_BOARD_AGENT_HINT,
+  workspaceTagTargetRef,
+  applyWorkspaceTags,
   readTurnLive,
   localhostPreviewUrl,
+  parseIssueSince,
+  formatGitHubSearchUpdatedSince,
+  issueMatchesUpdatedSince,
+  previewIssueCommentBody,
+  clampMcpIssueLimit,
+  applyIssueListWindow,
+  mcpIssueUpdatedSinceSchema,
+  formatListedIssuesForMcp,
+  mcpJson,
+  registerViewerContextTools,
   resolveScheduleThreadId,
   listSchedules,
   scheduleNeedsCaffeinate,