@sideboard-ai/core 0.1.279 → 0.1.281

package/dist/{chunk-TZ5JHIYK.js → chunk-2SJXQ4UX.js}

@@ -1,14 +1,11 @@
 #!/usr/bin/env node
 
 import {
-  allocateTeamName,
   canonicalizeRepoPath,
   ensureGhPreferOrigin,
   resolveGithubRepoSlug,
-  resolveRepoRoot,
-  takenSlugsFromThread,
-  teamSlugFromName
-} from "./chunk-K7MWJLR7.js";
+  resolveRepoRoot
+} from "./chunk-5MGLNVNK.js";
 import {
   ATTACHMENTS_DIR,
   attachmentsGitignoreBody
@@ -27,11 +24,14 @@ import {
   resolveViewerProfileForRepo
 } from "./chunk-WRIMAEF2.js";
 import {
+  allocateTeamName,
   createEmptyThread,
   listThreads,
+  takenSlugsFromThread,
+  teamSlugFromName,
   updateThread,
   writeThread
-} from "./chunk-JANCPF7Z.js";
+} from "./chunk-JPH7PYSK.js";
 import {
   appDataDir,
   globalAgentCwd,
@@ -341,21 +341,23 @@ var COORDINATOR_TOOL_PLAYBOOK = [
   `- list_branches / list_prs / list_issues \u2014 pass repoPath from list_projects. Review is PRs (the surface for assigned ticket work), not the tickets: "Get me N tickets to review" \u2192 list_prs(queue=review, limit=N) then create_workspace sourceType=pr. That is open non-draft PRs labeled with this project's ready-for-review GitHub label (Settings \u2192 Projects; default eng-review) with no individual user reviewer yet. A team request (engineering-team) is not a claim \u2014 the viewer is on that team and can pick it up; claimed means an individual account is the reviewer. Bots ignored. Use Settings \u2192 Agents / Projects context (roles, teams, labels \u2014 freeform text; project adds to account) to prefer the right queues. queue=mine is review-requested:@me; queue=approved|changes uses those labels. Also: state, label, reviewer=me|unassigned|login, query, limit default 40 max 250; raise limit or tighten when truncated. list_issues (query, assignee=me|unassigned|all|user, limit default 40 max 250) lists Linear, AbleTime, or GitHub tickets \u2014 do not use it for that review-inbox ask. When they ask for tickets to work on, follow their context (assignee=me or unassigned as it says).`,
   "- Find work: when they ask to find work, pick up tickets, or list reviews, use Settings \u2192 Agents (account) plus Settings \u2192 Projects (per-repo) context. Tickets \u2192 Sideboard list_issues / linear_* (Account Linear). Reviews \u2192 list_prs(queue=review). Do not call Claude Linear MCP or any other vendor Linear MCP \u2014 those HTTP connectors hang or flap on the first turn. If a vendor MCP is down or reconnecting, ignore it and keep going with Sideboard tools. Show the options \u2014 do not create_workspace or start unless they also asked to start (e.g. \u201Cfind me work and start it\u201D). Do not start this unprompted. To change that context, show the proposed text, ask_user (Save this context / Do not save), wait, then update_viewer_context with confirmed=true. Never write it without confirmation.",
   "- Ticket updates: list_issues / linear_search_issues / github_search_issues with updatedSince (yesterday, 2d, or ISO). One call returns new assignments, ticket edits, and new comments \u2014 do not get_issue every ticket just to check for comments. kind=created vs updated distinguishes new tickets from existing ones.",
-  "- linear_* (when Linear is connected) \u2014 list_teams for team key/states; get/create/update/comment with ENG-123. Worktree agents have the same Account tools \u2014 prefer they comment, update status, and create spin-offs (parent=) on their own ticket when they were asked to do the work. When reviewing a PR or ticket, do not comment or update until the user types a next step \u2014 they should work through the feedback in chat first. Do not tell the child to ask_user after the review. Scope errors: reconnect Linear in Account settings. Prefer these over any Linear MCP the CLI may still list.",
-  "- github_* \u2014 get/comment/update/create GitHub issues via Account `gh` (#123). Worktree agents have these too. Prefer over any vendor GitHub MCP. Pass parent= for spin-offs. When reviewing a PR or ticket, do not comment, submit `gh pr review`, or update the PR/ticket until the user types a next step.",
-  "- abletime_* (when AbleTime is connected) \u2014 orientation first; get/comment/update/create (parent= for spin-offs); ensure_task when work has no ticket (or create_workspace from the default branch auto-creates one). Worktree agents have the same Account tools. Same review-write gate as Linear/GitHub.",
-  "- Optional connectors (Vercel, Supabase, PostHog, Sentry) in Settings \u2192 Connectors inject tokens into worktree agent env when connected. Prefer official CLIs (`vercel`, `supabase`, `sentry-cli`) with those env vars. PostHog has no first-class CLI \u2014 use the HTTP API (`POSTHOG_PERSONAL_API_KEY`). Tell any worktree agent (Claude / Cursor / Codex / OpenCode) to write CLI output to `.context/cli/` (not `.context/attachments/`) and read a slice \u2014 never stream raw `--json` / `--expand` into a tool result (that crashes the turn). They can `stop_job` if a detached fetch hangs. If a CLI is missing, the user can Install CLI on that row (not auto-installed on Connect). Do not add vendor MCPs or ask the user to paste tokens again. Git (`gh`) stays Settings \u2192 Git; issue tracking stays Settings \u2192 Issues. The phone remote is Settings \u2192 Remote \u2014 do not look up Slack users.",
+  "- linear_* (when Linear is connected) \u2014 list_teams for team key/states; linear_list_projects for project names; get/search include the project a ticket is on; get/create/update/comment with ENG-123. Worktree agents have the same Account tools \u2014 prefer they comment, update status, and create spin-offs (parent=) on their own ticket when they were asked to do the work. When reviewing a PR or ticket, do not comment or update until the user types a next step \u2014 they should work through the feedback in chat first. Do not tell the child to ask_user after the review. Scope errors: reconnect Linear in Account settings. Prefer these over any Linear MCP the CLI may still list.",
+  "- github_* \u2014 get/comment/update/create GitHub issues via Account `gh` (#123). github_list_projects and get/search include GitHub Projects. projectsError or a missing read:project scope \u2192 `gh auth refresh -s read:project`. Worktree agents have these too. Prefer over any vendor GitHub MCP. Pass parent= for spin-offs. When reviewing a PR or ticket, do not comment, submit `gh pr review`, or update the PR/ticket until the user types a next step.",
+  "- abletime_* (when AbleTime is connected) \u2014 orientation first; abletime_list_projects lists projects; get/list include the project a task is on; get/comment/update/create (parent= for spin-offs); ensure_task when work has no ticket (or create_workspace from the default branch auto-creates one). Worktree agents have the same Account tools. Same review-write gate as Linear/GitHub.",
+  "- Optional connectors (Vercel, Supabase, PostHog, Sentry) in Settings \u2192 Connectors inject tokens into worktree agent env when connected. Prefer official CLIs (`vercel`, `supabase`, `sentry-cli`) with those env vars. PostHog has no first-class CLI \u2014 use the HTTP API (`POSTHOG_PERSONAL_API_KEY`). If a connector MCP is listed but needsAuth or unauthorized, do not sign in \u2014 check that native CLI or HTTP API. Tell any worktree agent (Claude / Cursor / Codex / OpenCode) to write CLI output to `.context/cli/` (not `.context/attachments/`) and read a slice \u2014 never stream raw `--json` / `--expand` into a tool result (that crashes the turn). They can `stop_job` if a detached fetch hangs. If a CLI is missing, the user can Install CLI on that row (not auto-installed on Connect). Do not add vendor MCPs or ask the user to paste tokens again. Git (`gh`) stays Settings \u2192 Git; issue tracking stays Settings \u2192 Issues. The phone remote is Settings \u2192 Remote \u2014 do not look up Slack users.",
   "- get_pr_stack / open_pr_stack_layers / add_stack_layer / create_pr_stack \u2014 GitHub stacked PRs (`gh stack`); one worktree per layer",
   "- list_models \u2014 only when you need a specific model (rare); otherwise omit model so Account defaults apply",
   "- list_chats / get_chat \u2014 live thread list (parent id + last message preview). get_chat on this orchestration chat lists child worktree agents (status + lastText). blockedReason is why that agent is waiting on a person. Also includes usage / lastTurnUsage.",
   "- ask_user \u2014 composer multiple-choice only when blocked on a concrete choice (approach fork, which API, Save this context / Do not save). Never for hellos, check-ins, invented \u201Cwhat should we do?\u201D menus, or after a review \u2014 reply in chat. Explain options first, description on every option, then wait.",
   "- get_viewer_context / update_viewer_context \u2014 read or replace Settings \u2192 Agents (account) and Settings \u2192 Projects (per-repo) context. You can update a project: pass scope=project and repoPath from list_projects (this cwd is not a project). update_viewer_context requires confirmed=true after ask_user. Never write context unprompted.",
+  "- list_env / set_env / delete_env \u2014 Settings \u2192 Environment. scope=project requires repoPath from list_projects and stores the key under that project prefix (the project name, uppercased, plus _). APPLE_ID for sideboard is SIDEBOARD_APPLE_ID. scope=account is shared by every project and is not prefixed. list_env returns names only.",
   "- set_caffeinate \u2014 keep this Mac awake across turns (macOS caffeinate). Turn on for phone remote / away-from-keyboard work, overnight schedules, or when the user will be away. Turn OFF when they say they are done, wrapping up, going to sleep, or no longer need the machine awake. Closing this chat also releases it.",
   "- list_schedules / create_schedule / update_schedule / delete_schedule / run_schedule \u2014 local jobs that send a prompt to a chat (chatId or self) or start a new Global chat (omit chatId). One-shot `at`, interval `every` (15m/1h/6h/1d), or 5-field `cron`. Recurring jobs without chatId open a new chat each run. Worktree agents have the same tools (`chatId=self` continues that coding chat). Jobs fire only while Sideboard.app is running; sleep skips until wake. Creating or enabling a future job turns on Settings \u2192 Advanced \u2192 Caffeinate while schedules are enabled (or call set_caffeinate).",
   "Projects:",
   "- add_project / remove_project \u2014 register or unregister a git repo",
   "Workspaces and chats:",
-  "- create_workspace \u2014 create a workspace (isolated checkout + first chat) from branch | pr | ticket (appears on Home). A ticket, PR, or named branch has one checkout: a second call returns that workspace (alreadyStarted=true) and chats for every agent already on it. That is not one agent. To put another agent on that checkout, fork_chat. send_to_chat only the chat that should do this job. Creating from the default branch still opens a new isolated workspace. Pass repoPath + parentChatId; omit agent and model so Sideboard applies Settings \u2192 Default agent, model & effort (never pass your own agent or agent=cursor). If the repo has a setup script, Sideboard runs it in the background (does not block send_to_chat). Nested Codex (you are Codex and the child would be Codex) can deadlock on ~/.codex locks \u2014 omit agent; Sideboard switches the child to Cursor when a CURSOR_API_KEY is set, otherwise keeps the Account default",
+  '- create_workspace \u2014 create a workspace (isolated checkout + first chat) from branch | pr | ticket (appears on Home). A ticket, PR, or named branch has one checkout: a second call returns that workspace (alreadyStarted=true) and chats for every agent already on it. That is not one agent. To put another agent on that checkout, fork_chat. send_to_chat only the chat that should do this job. Creating from the default branch still opens a new isolated workspace. Pass repoPath + parentChatId; omit agent and model so Sideboard applies Settings \u2192 Default agent, model & effort (never pass your own agent or agent=cursor). Pass the same tags (short labels, e.g. "phone-sync") on every workspace you open for one task so they group in the sidebar; reusing a checkout adds those tags. If the repo has a setup script, Sideboard runs it in the background (does not block send_to_chat). Nested Codex (you are Codex and the child would be Codex) can deadlock on ~/.codex locks \u2014 omit agent; Sideboard switches the child to Cursor when a CURSOR_API_KEY is set, otherwise keeps the Account default',
+  "- set_workspace_tags \u2014 set, add, or remove labels on a workspace after create. Pass any chat id on that checkout. Same tags on every workspace from one task. Worktree agents can update tags on their own checkout (they omit ref).",
   "- start_board_card \u2014 same as create_workspace for a ticket/PR/named branch (attaches issue text when resolvable). Then send_to_chat.",
   "- fork_workspace \u2014 fork a worktree chat into a NEW git worktree + chat (transcript attached); optional agent; leave model unset (Auto) unless you have a reason. Not for orchestration chats.",
   "- fork_chat \u2014 add another agent on the SAME workspace (same files, Run, and git), or fork a Global orchestration chat into a new tab. Pass agent when it should be a different harness. Leave model unset (Auto) unless you have a reason. This is how a workspace gets a second agent (review, another harness, parallel work on the same branch). Do not create_workspace again for that. Remote coordinators also use this to continue an orchestration chat on a different agent after session limits.",
@@ -813,20 +815,55 @@ function writeRemoved(paths) {
   mkdirSync3(appDataDir(), { recursive: true });
   writeFileSync3(removedWorkspacesFile(), JSON.stringify([...paths].sort(), null, 2), "utf8");
 }
+function canonicalWorkspacePath(repoPath) {
+  return canonicalizeRepoPath(repoPath);
+}
+function sameWorkspacePath(a, b) {
+  if (!a || !b) return false;
+  const left = canonicalWorkspacePath(a);
+  const right = canonicalWorkspacePath(b);
+  if (left === right) return true;
+  const primaryA = primaryCheckoutFromLinkedWorktree(a);
+  const primaryB = primaryCheckoutFromLinkedWorktree(b);
+  if (primaryA && (primaryA === right || primaryA === primaryB)) return true;
+  if (primaryB && primaryB === left) return true;
+  return false;
+}
+function removedMatches(saved, repoPath) {
+  if (saved === repoPath || sameWorkspacePath(saved, repoPath)) return true;
+  const primary = primaryCheckoutFromLinkedWorktree(repoPath);
+  return Boolean(primary && sameWorkspacePath(saved, primary));
+}
+function isRemovedWorkspace(repoPath) {
+  if (!repoPath) return false;
+  for (const saved of readRemoved()) {
+    if (removedMatches(saved, repoPath)) return true;
+  }
+  return false;
+}
 function rememberRemoved(repoPath) {
   const next = readRemoved();
-  next.add(repoPath);
-  writeRemoved(next);
+  const before = next.size;
+  const canon = canonicalWorkspacePath(repoPath);
+  next.add(canon);
+  const raw = repoPath.replace(/\/+$/, "");
+  if (raw && raw !== canon) next.add(raw);
+  if (next.size !== before) writeRemoved(next);
 }
 function forgetRemoved(repoPath) {
   const next = readRemoved();
-  if (!next.delete(repoPath)) return;
-  writeRemoved(next);
+  let changed = false;
+  for (const saved of [...next]) {
+    if (!removedMatches(saved, repoPath)) continue;
+    next.delete(saved);
+    changed = true;
+  }
+  if (changed) writeRemoved(next);
 }
 function listWorkspaces() {
   const all = readAll();
   const valid = all.filter(
-    (w) => Boolean(w.path) && w.path !== "/" && w.path !== "." && !isGlobalRepoPath(w.path)
+    (w) => Boolean(w.path) && w.path !== "/" && w.path !== "." && !isGlobalRepoPath(w.path) && !isRemovedWorkspace(w.path)
   );
   if (valid.length !== all.length) writeAll(valid);
   return valid.sort((a, b) => a.name.localeCompare(b.name));
@@ -871,6 +908,9 @@ async function addWorkspace(repoPath) {
   if (!root || root === "/") throw new Error(`Invalid repo path: ${repoPath}`);
   if (!existsSync2(root)) throw new Error(`Repo not found: ${root}`);
   forgetRemoved(root);
+  return registerWorkspace(root);
+}
+async function registerWorkspace(root) {
   await ensureGhPreferOrigin(root);
   const current = readAll();
   const existing = current.find((w) => w.path === root);
@@ -885,21 +925,26 @@ async function addWorkspace(repoPath) {
   return next;
 }
 function removeWorkspace(repoPath) {
-  writeAll(readAll().filter((w) => w.path !== repoPath));
   rememberRemoved(repoPath);
+  const canon = canonicalWorkspacePath(repoPath);
+  writeAll(readAll().filter((w) => !sameWorkspacePath(w.path, canon)));
 }
 async function ensureWorkspace(repoPath) {
-  return addWorkspace(repoPath);
+  const root = await resolveRepoRoot(repoPath);
+  if (!root || root === "/" || !existsSync2(root)) {
+    throw new Error(`Invalid repo path: ${repoPath}`);
+  }
+  if (isRemovedWorkspace(root)) throw new Error(`Project was removed: ${root}`);
+  return registerWorkspace(root);
 }
 function syncWorkspacesFromThreads(repoPaths) {
   const current = readAll();
-  const removed = readRemoved();
   const byPath = /* @__PURE__ */ new Map();
   let dirty = false;
   for (const w of current) {
     const resolved = resolveSyncWorkspacePath(w.path) ?? w.path;
     if (resolved !== w.path) dirty = true;
-    if (!resolved || resolved === "/" || isGlobalRepoPath(resolved) || removed.has(resolved)) {
+    if (!resolved || resolved === "/" || isGlobalRepoPath(resolved) || isRemovedWorkspace(resolved)) {
       dirty = true;
       continue;
     }
@@ -912,7 +957,7 @@ function syncWorkspacesFromThreads(repoPaths) {
   }
   for (const raw of repoPaths) {
     const path = resolveSyncWorkspacePath(raw);
-    if (!path || path === "/" || isGlobalRepoPath(path) || byPath.has(path) || removed.has(path)) {
+    if (!path || path === "/" || isGlobalRepoPath(path) || byPath.has(path) || isRemovedWorkspace(path)) {
       continue;
     }
     if (!existsSync2(path)) continue;
@@ -941,6 +986,8 @@ export {
   stageBuffersAsAttachments,
   persistPendingFileAttachments,
   attachmentsFromWorktreePaths,
+  sameWorkspacePath,
+  isRemovedWorkspace,
   listWorkspaces,
   primaryCheckoutFromLinkedWorktree,
   addWorkspace,