@sideboard-ai/core 0.1.85 → 0.1.87

package/dist/{chunk-M37RITA6.js → chunk-B4R2VB2A.js}

@@ -1,17 +1,136 @@
 // src/store/paths.ts
 import { basename } from "path";
 import { homedir as homedir2 } from "os";
-import { join as join2 } from "path";
+import { join as join4 } from "path";
 import { mkdirSync } from "fs";
 
 // src/hook/settings.ts
-import { existsSync, readFileSync } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
 import { homedir } from "os";
-import { join } from "path";
+import { join as join3 } from "path";
 import { parse as parseToml } from "smol-toml";
+
+// src/hook/convention-setup.ts
+import { existsSync, statSync } from "fs";
+import { join } from "path";
+var CONVENTION_SETUP_RELPATHS = [
+  "script/setup",
+  "bin/setup",
+  "scripts/setup.sh",
+  "scripts/setup"
+];
+function isFile(path) {
+  try {
+    return statSync(path).isFile();
+  } catch {
+    return false;
+  }
+}
+function normPath(p) {
+  return p.replace(/\/+$/, "");
+}
+function findConventionSetup(worktreePath, repoPath) {
+  const roots = [
+    { root: worktreePath, where: "worktree" }
+  ];
+  if (repoPath && normPath(repoPath) !== normPath(worktreePath)) {
+    roots.push({ root: repoPath, where: "main repo" });
+  }
+  for (const { root, where } of roots) {
+    for (const relPath of CONVENTION_SETUP_RELPATHS) {
+      const absPath = join(root, relPath);
+      if (!existsSync(absPath) || !isFile(absPath)) continue;
+      return {
+        relPath,
+        absPath,
+        command: `bash ${JSON.stringify(absPath)}`,
+        source: `${relPath} (${where})`
+      };
+    }
+  }
+  return null;
+}
+function hasConventionSetup(worktreePath, repoPath) {
+  return findConventionSetup(worktreePath, repoPath) !== null;
+}
+
+// src/hook/cursor-worktrees.ts
+import { existsSync as existsSync2, readFileSync } from "fs";
+import { join as join2 } from "path";
+import { execa } from "execa";
+import { createInterface } from "readline";
+function loadCursorWorktreesJson(rootPath) {
+  const path = join2(rootPath, ".cursor", "worktrees.json");
+  if (!existsSync2(path)) return null;
+  try {
+    return JSON.parse(readFileSync(path, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function resolveSetupSpec(config) {
+  if (process.platform === "win32") {
+    return config["setup-worktree-windows"] ?? config["setup-worktree"] ?? null;
+  }
+  return config["setup-worktree-unix"] ?? config["setup-worktree"] ?? null;
+}
+async function runCursorWorktreeSetup(repoPath, worktreePath, onLine) {
+  const fromWorktree = loadCursorWorktreesJson(worktreePath);
+  const fromRepo = worktreePath !== repoPath ? loadCursorWorktreesJson(repoPath) : null;
+  const config = fromWorktree ?? fromRepo;
+  if (!config) return { ran: false, exitCode: null, source: null };
+  const spec = resolveSetupSpec(config);
+  if (!spec) return { ran: false, exitCode: null, source: null };
+  const sourceLabel = fromWorktree ? ".cursor/worktrees.json (worktree)" : ".cursor/worktrees.json (main repo)";
+  const env = {
+    ...process.env,
+    ROOT_WORKTREE_PATH: repoPath
+  };
+  if (process.platform === "win32") {
+    env.ROOT_WORKTREE_PATH = repoPath;
+  }
+  const commands = Array.isArray(spec) ? spec : [spec.endsWith(".sh") || spec.endsWith(".ps1") ? join2(
+    fromWorktree ? worktreePath : repoPath,
+    ".cursor",
+    spec
+  ) : spec];
+  let lastExit = 0;
+  for (const command of commands) {
+    const isScriptPath = typeof spec === "string" && (spec.endsWith(".sh") || spec.endsWith(".ps1"));
+    const shell = process.platform === "win32" ? "powershell" : "bash";
+    const args = process.platform === "win32" ? isScriptPath ? ["-File", command] : ["-Command", command] : isScriptPath ? [command] : ["-lc", command];
+    onLine?.(`[cursor setup] ${command}`);
+    const child = execa(shell, args, {
+      cwd: worktreePath,
+      reject: false,
+      env
+    });
+    if (child.stdout && onLine) {
+      const rl = createInterface({ input: child.stdout });
+      rl.on("line", onLine);
+    }
+    if (child.stderr && onLine) {
+      const rl = createInterface({ input: child.stderr });
+      rl.on("line", onLine);
+    }
+    const result = await child;
+    lastExit = result.exitCode ?? null;
+    if (lastExit !== 0 && lastExit !== null) break;
+  }
+  return { ran: true, exitCode: lastExit, source: sourceLabel };
+}
+function hasCursorWorktreeSetup(worktreePath, repoPath) {
+  if (loadCursorWorktreesJson(worktreePath)) return true;
+  if (repoPath && repoPath !== worktreePath && loadCursorWorktreesJson(repoPath)) {
+    return true;
+  }
+  return false;
+}
+
+// src/hook/settings.ts
 function expandHome(path) {
   if (path.startsWith("~/") || path === "~") {
-    return join(homedir(), path.slice(2));
+    return join3(homedir(), path.slice(2));
   }
   return path;
 }
@@ -24,8 +143,8 @@ function parseAvailableIn(raw) {
   return out.length ? out : void 0;
 }
 function parseSettingsFile(path, source) {
-  if (!existsSync(path)) return null;
-  const raw = readFileSync(path, "utf8");
+  if (!existsSync3(path)) return null;
+  const raw = readFileSync2(path, "utf8");
   const data = parseToml(raw);
   const scripts = data.scripts ?? {};
   const setup = typeof scripts.setup === "string" ? scripts.setup : void 0;
@@ -128,15 +247,15 @@ function finalizeSettings(parsed) {
   };
 }
 function familyFiles(rootPath, source) {
-  const dir = join(rootPath, `.${source}`);
+  const dir = join3(rootPath, `.${source}`);
   return {
-    toml: join(dir, "settings.toml"),
-    local: join(dir, "settings.local.toml")
+    toml: join3(dir, "settings.toml"),
+    local: join3(dir, "settings.local.toml")
   };
 }
 function familyExists(rootPath, source) {
   const files = familyFiles(rootPath, source);
-  return existsSync(files.toml) || existsSync(files.local);
+  return existsSync3(files.toml) || existsSync3(files.local);
 }
 function detectFamily(rootPath) {
   if (familyExists(rootPath, "sideboard")) return "sideboard";
@@ -155,7 +274,7 @@ function loadAnyLocal(rootPath) {
     loadLocalToml(rootPath, "sideboard")
   );
 }
-function normPath(p) {
+function normPath2(p) {
   return p.replace(/\/+$/, "");
 }
 function loadRepoSettings(repoPath) {
@@ -169,11 +288,11 @@ function loadRepoSettings(repoPath) {
 }
 function loadWorkspaceSettings(worktreePath, repoPath) {
   const wtFamily = detectFamily(worktreePath);
-  const repoFamily = repoPath && normPath(repoPath) !== normPath(worktreePath) ? detectFamily(repoPath) : null;
+  const repoFamily = repoPath && normPath2(repoPath) !== normPath2(worktreePath) ? detectFamily(repoPath) : null;
   const wtToml = wtFamily ? loadCommittedToml(worktreePath, wtFamily) : null;
   const repoToml = repoPath && repoFamily ? loadCommittedToml(repoPath, repoFamily) : null;
   let merged = wtToml ?? repoToml;
-  if (repoPath && normPath(repoPath) !== normPath(worktreePath)) {
+  if (repoPath && normPath2(repoPath) !== normPath2(worktreePath)) {
     merged = mergeSettings(merged, loadAnyLocal(repoPath));
   }
   merged = mergeSettings(merged, loadAnyLocal(worktreePath));
@@ -187,7 +306,7 @@ function hasRepoHook(repoPath) {
 }
 function hasWorkspaceHook(worktreePath, repoPath) {
   if (hasRepoHook(worktreePath)) return true;
-  if (repoPath && normPath(repoPath) !== normPath(worktreePath) && hasRepoHook(repoPath)) {
+  if (repoPath && normPath2(repoPath) !== normPath2(worktreePath) && hasRepoHook(repoPath)) {
     return true;
   }
   return false;
@@ -199,16 +318,16 @@ function settingsSourceLabel(rootPath) {
   const family = detectFamily(rootPath);
   if (!family) return null;
   const files = familyFiles(rootPath, family);
-  if (existsSync(files.toml) && existsSync(files.local)) {
+  if (existsSync3(files.toml) && existsSync3(files.local)) {
     return `.${family}/settings.toml + local`;
   }
-  if (existsSync(files.local)) return `.${family}/settings.local.toml`;
+  if (existsSync3(files.local)) return `.${family}/settings.local.toml`;
   return `.${family}/settings.toml`;
 }
 function workspaceSettingsSourceLabel(worktreePath, repoPath) {
   const wt = settingsSourceLabel(worktreePath);
   if (wt) return `${wt} (worktree)`;
-  if (repoPath && normPath(repoPath) !== normPath(worktreePath)) {
+  if (repoPath && normPath2(repoPath) !== normPath2(worktreePath)) {
     const repo = settingsSourceLabel(repoPath);
     if (repo) return `${repo} (main repo)`;
   }
@@ -216,42 +335,52 @@ function workspaceSettingsSourceLabel(worktreePath, repoPath) {
 }
 function getRepoSetupInfo(worktreePath, repoPath) {
   const settings = loadWorkspaceSettings(worktreePath, repoPath);
+  const convention = findConventionSetup(worktreePath, repoPath);
+  const cursor = hasCursorWorktreeSetup(worktreePath, repoPath);
+  const hasSetupScript = Boolean(settings?.setup) || cursor || Boolean(convention);
+  let configLabel = workspaceSettingsSourceLabel(worktreePath, repoPath);
+  if (!settings?.setup) {
+    if (convention) configLabel = convention.source;
+    else if (cursor) {
+      configLabel = hasCursorWorktreeSetup(worktreePath) ? ".cursor/worktrees.json (worktree)" : ".cursor/worktrees.json (main repo)";
+    }
+  }
   return {
-    hasConfig: hasWorkspaceHook(worktreePath, repoPath),
-    hasSetupScript: Boolean(settings?.setup),
-    configLabel: workspaceSettingsSourceLabel(worktreePath, repoPath)
+    hasConfig: hasWorkspaceHook(worktreePath, repoPath) || cursor || Boolean(convention),
+    hasSetupScript,
+    configLabel
   };
 }
 
 // src/store/paths.ts
 function appDataDir() {
   const override = process.env.SIDEBOARD_APP_DATA?.trim();
-  const base = override ? override : process.platform === "darwin" ? join2(homedir2(), "Library", "Application Support", "sideboard") : process.platform === "win32" ? join2(process.env.APPDATA ?? join2(homedir2(), "AppData", "Roaming"), "sideboard") : join2(homedir2(), ".local", "share", "sideboard");
+  const base = override ? override : process.platform === "darwin" ? join4(homedir2(), "Library", "Application Support", "sideboard") : process.platform === "win32" ? join4(process.env.APPDATA ?? join4(homedir2(), "AppData", "Roaming"), "sideboard") : join4(homedir2(), ".local", "share", "sideboard");
   mkdirSync(base, { recursive: true });
   return base;
 }
 function threadsDir() {
-  const dir = join2(appDataDir(), "threads");
+  const dir = join4(appDataDir(), "threads");
   mkdirSync(dir, { recursive: true });
   return dir;
 }
 function locksDir() {
-  const dir = join2(appDataDir(), "locks");
+  const dir = join4(appDataDir(), "locks");
   mkdirSync(dir, { recursive: true });
   return dir;
 }
 function sideboardHomeDir() {
-  const dir = join2(homedir2(), "sideboard");
+  const dir = join4(homedir2(), "sideboard");
   mkdirSync(dir, { recursive: true });
   return dir;
 }
 function sideboardReposDir() {
-  const dir = join2(sideboardHomeDir(), "repos");
+  const dir = join4(sideboardHomeDir(), "repos");
   mkdirSync(dir, { recursive: true });
   return dir;
 }
 function sideboardWorkspacesDir() {
-  const dir = join2(sideboardHomeDir(), "workspaces");
+  const dir = join4(sideboardHomeDir(), "workspaces");
   mkdirSync(dir, { recursive: true });
   return dir;
 }
@@ -264,23 +393,28 @@ function worktreesRoot(repoPath) {
     mkdirSync(settings.worktreesRoot, { recursive: true });
     return settings.worktreesRoot;
   }
-  const dir = join2(sideboardWorkspacesDir(), repoSlug(repoPath));
+  const dir = join4(sideboardWorkspacesDir(), repoSlug(repoPath));
   mkdirSync(dir, { recursive: true });
   return dir;
 }
 function threadFilePath(id) {
-  return join2(threadsDir(), `${id}.json`);
+  return join4(threadsDir(), `${id}.json`);
 }
 function threadLockPath(id) {
-  return join2(locksDir(), `${id}.lock`);
+  return join4(locksDir(), `${id}.lock`);
 }
 function globalAgentCwd() {
-  const dir = join2(appDataDir(), "global");
+  const dir = join4(appDataDir(), "global");
   mkdirSync(dir, { recursive: true });
   return dir;
 }
 
 export {
+  CONVENTION_SETUP_RELPATHS,
+  findConventionSetup,
+  hasConventionSetup,
+  runCursorWorktreeSetup,
+  hasCursorWorktreeSetup,
   loadRepoSettings,
   loadWorkspaceSettings,
   loadConductorSettings,

package/dist/{chunk-6WQAYBVE.js → chunk-CY45C3GA.js}

@@ -5,14 +5,14 @@ import {
 } from "./chunk-B3SJXYIJ.js";
 import {
   listThreads
-} from "./chunk-7FD7COKE.js";
+} from "./chunk-JOF3XIEM.js";
 import {
   getGithubGitAuthMode,
   getGithubPat
-} from "./chunk-AY53MPDE.js";
+} from "./chunk-TC2KY5G7.js";
 import {
   worktreesRoot
-} from "./chunk-7MV3RXSC.js";
+} from "./chunk-JL4SJ6V7.js";
 import {
   gh,
   git,
@@ -1025,7 +1025,7 @@ function formatGitAuthModeDirective(mode) {
     default:
       return [
         "Git authentication (Account \u2192 GitHub mode: auto):",
-        "- This process rewrites GitHub SSH remotes to HTTPS and authenticates with `GH_TOKEN` from `gh` so git/ssh never prompt the macOS Keychain (required for Slack / unattended Cursor).",
+        "- This process rewrites GitHub SSH remotes to HTTPS and authenticates with `GH_TOKEN` from `gh` so git/ssh never prompt the macOS Keychain (required for unattended orchestrator turns).",
         "- Do not switch remotes to SSH. Push with `git push -u origin HEAD`.",
         "- If HTTPS auth fails, tell the user to run `gh auth login` on this Mac or set Account \u2192 GitHub to a PAT \u2014 do not wait for a Keychain dialog."
       ].join("\n");

package/dist/{chunk-6K5VAPVR.js → chunk-DKHGWYWR.js}

@@ -2,7 +2,7 @@
 
 import {
   appDataDir
-} from "./chunk-7MV3RXSC.js";
+} from "./chunk-JL4SJ6V7.js";
 import {
   run
 } from "./chunk-3KETJKYA.js";

package/dist/{chunk-2N5DVTGH.js → chunk-HBXQQ5TO.js}

@@ -1,13 +1,13 @@
 import {
   isGlobalRepoPath
-} from "./chunk-JTHWVYSD.js";
+} from "./chunk-4PTN2LED.js";
 import {
   ensureGhPreferOrigin,
   resolveRepoRoot
-} from "./chunk-KRAUS3RF.js";
+} from "./chunk-L63LLCTX.js";
 import {
   appDataDir
-} from "./chunk-M37RITA6.js";
+} from "./chunk-B4R2VB2A.js";
 
 // src/store/workspaces.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";

package/dist/{chunk-7MV3RXSC.js → chunk-JL4SJ6V7.js}

@@ -4,17 +4,126 @@
 // src/store/paths.ts
 import { basename } from "path";
 import { homedir as homedir2 } from "os";
-import { join as join2 } from "path";
+import { join as join4 } from "path";
 import { mkdirSync } from "fs";
 
 // src/hook/settings.ts
-import { existsSync, readFileSync } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
 import { homedir } from "os";
-import { join } from "path";
+import { join as join3 } from "path";
 import { parse as parseToml } from "smol-toml";
+
+// src/hook/convention-setup.ts
+import { existsSync, statSync } from "fs";
+import { join } from "path";
+var CONVENTION_SETUP_RELPATHS = [
+  "script/setup",
+  "bin/setup",
+  "scripts/setup.sh",
+  "scripts/setup"
+];
+function isFile(path) {
+  try {
+    return statSync(path).isFile();
+  } catch {
+    return false;
+  }
+}
+function normPath(p) {
+  return p.replace(/\/+$/, "");
+}
+function findConventionSetup(worktreePath, repoPath) {
+  const roots = [
+    { root: worktreePath, where: "worktree" }
+  ];
+  if (repoPath && normPath(repoPath) !== normPath(worktreePath)) {
+    roots.push({ root: repoPath, where: "main repo" });
+  }
+  for (const { root, where } of roots) {
+    for (const relPath of CONVENTION_SETUP_RELPATHS) {
+      const absPath = join(root, relPath);
+      if (!existsSync(absPath) || !isFile(absPath)) continue;
+      return {
+        relPath,
+        absPath,
+        command: `bash ${JSON.stringify(absPath)}`,
+        source: `${relPath} (${where})`
+      };
+    }
+  }
+  return null;
+}
+
+// src/hook/cursor-worktrees.ts
+import { existsSync as existsSync2, readFileSync } from "fs";
+import { join as join2 } from "path";
+import { execa } from "execa";
+import { createInterface } from "readline";
+function loadCursorWorktreesJson(rootPath) {
+  const path = join2(rootPath, ".cursor", "worktrees.json");
+  if (!existsSync2(path)) return null;
+  try {
+    return JSON.parse(readFileSync(path, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function resolveSetupSpec(config) {
+  if (process.platform === "win32") {
+    return config["setup-worktree-windows"] ?? config["setup-worktree"] ?? null;
+  }
+  return config["setup-worktree-unix"] ?? config["setup-worktree"] ?? null;
+}
+async function runCursorWorktreeSetup(repoPath, worktreePath, onLine) {
+  const fromWorktree = loadCursorWorktreesJson(worktreePath);
+  const fromRepo = worktreePath !== repoPath ? loadCursorWorktreesJson(repoPath) : null;
+  const config = fromWorktree ?? fromRepo;
+  if (!config) return { ran: false, exitCode: null, source: null };
+  const spec = resolveSetupSpec(config);
+  if (!spec) return { ran: false, exitCode: null, source: null };
+  const sourceLabel = fromWorktree ? ".cursor/worktrees.json (worktree)" : ".cursor/worktrees.json (main repo)";
+  const env = {
+    ...process.env,
+    ROOT_WORKTREE_PATH: repoPath
+  };
+  if (process.platform === "win32") {
+    env.ROOT_WORKTREE_PATH = repoPath;
+  }
+  const commands = Array.isArray(spec) ? spec : [spec.endsWith(".sh") || spec.endsWith(".ps1") ? join2(
+    fromWorktree ? worktreePath : repoPath,
+    ".cursor",
+    spec
+  ) : spec];
+  let lastExit = 0;
+  for (const command of commands) {
+    const isScriptPath = typeof spec === "string" && (spec.endsWith(".sh") || spec.endsWith(".ps1"));
+    const shell = process.platform === "win32" ? "powershell" : "bash";
+    const args = process.platform === "win32" ? isScriptPath ? ["-File", command] : ["-Command", command] : isScriptPath ? [command] : ["-lc", command];
+    onLine?.(`[cursor setup] ${command}`);
+    const child = execa(shell, args, {
+      cwd: worktreePath,
+      reject: false,
+      env
+    });
+    if (child.stdout && onLine) {
+      const rl = createInterface({ input: child.stdout });
+      rl.on("line", onLine);
+    }
+    if (child.stderr && onLine) {
+      const rl = createInterface({ input: child.stderr });
+      rl.on("line", onLine);
+    }
+    const result = await child;
+    lastExit = result.exitCode ?? null;
+    if (lastExit !== 0 && lastExit !== null) break;
+  }
+  return { ran: true, exitCode: lastExit, source: sourceLabel };
+}
+
+// src/hook/settings.ts
 function expandHome(path) {
   if (path.startsWith("~/") || path === "~") {
-    return join(homedir(), path.slice(2));
+    return join3(homedir(), path.slice(2));
   }
   return path;
 }
@@ -27,8 +136,8 @@ function parseAvailableIn(raw) {
   return out.length ? out : void 0;
 }
 function parseSettingsFile(path, source) {
-  if (!existsSync(path)) return null;
-  const raw = readFileSync(path, "utf8");
+  if (!existsSync3(path)) return null;
+  const raw = readFileSync2(path, "utf8");
   const data = parseToml(raw);
   const scripts = data.scripts ?? {};
   const setup = typeof scripts.setup === "string" ? scripts.setup : void 0;
@@ -131,15 +240,15 @@ function finalizeSettings(parsed) {
   };
 }
 function familyFiles(rootPath, source) {
-  const dir = join(rootPath, `.${source}`);
+  const dir = join3(rootPath, `.${source}`);
   return {
-    toml: join(dir, "settings.toml"),
-    local: join(dir, "settings.local.toml")
+    toml: join3(dir, "settings.toml"),
+    local: join3(dir, "settings.local.toml")
   };
 }
 function familyExists(rootPath, source) {
   const files = familyFiles(rootPath, source);
-  return existsSync(files.toml) || existsSync(files.local);
+  return existsSync3(files.toml) || existsSync3(files.local);
 }
 function detectFamily(rootPath) {
   if (familyExists(rootPath, "sideboard")) return "sideboard";
@@ -158,7 +267,7 @@ function loadAnyLocal(rootPath) {
     loadLocalToml(rootPath, "sideboard")
   );
 }
-function normPath(p) {
+function normPath2(p) {
   return p.replace(/\/+$/, "");
 }
 function loadRepoSettings(repoPath) {
@@ -172,11 +281,11 @@ function loadRepoSettings(repoPath) {
 }
 function loadWorkspaceSettings(worktreePath, repoPath) {
   const wtFamily = detectFamily(worktreePath);
-  const repoFamily = repoPath && normPath(repoPath) !== normPath(worktreePath) ? detectFamily(repoPath) : null;
+  const repoFamily = repoPath && normPath2(repoPath) !== normPath2(worktreePath) ? detectFamily(repoPath) : null;
   const wtToml = wtFamily ? loadCommittedToml(worktreePath, wtFamily) : null;
   const repoToml = repoPath && repoFamily ? loadCommittedToml(repoPath, repoFamily) : null;
   let merged = wtToml ?? repoToml;
-  if (repoPath && normPath(repoPath) !== normPath(worktreePath)) {
+  if (repoPath && normPath2(repoPath) !== normPath2(worktreePath)) {
     merged = mergeSettings(merged, loadAnyLocal(repoPath));
   }
   merged = mergeSettings(merged, loadAnyLocal(worktreePath));
@@ -186,16 +295,16 @@ function settingsSourceLabel(rootPath) {
   const family = detectFamily(rootPath);
   if (!family) return null;
   const files = familyFiles(rootPath, family);
-  if (existsSync(files.toml) && existsSync(files.local)) {
+  if (existsSync3(files.toml) && existsSync3(files.local)) {
     return `.${family}/settings.toml + local`;
   }
-  if (existsSync(files.local)) return `.${family}/settings.local.toml`;
+  if (existsSync3(files.local)) return `.${family}/settings.local.toml`;
   return `.${family}/settings.toml`;
 }
 function workspaceSettingsSourceLabel(worktreePath, repoPath) {
   const wt = settingsSourceLabel(worktreePath);
   if (wt) return `${wt} (worktree)`;
-  if (repoPath && normPath(repoPath) !== normPath(worktreePath)) {
+  if (repoPath && normPath2(repoPath) !== normPath2(worktreePath)) {
     const repo = settingsSourceLabel(repoPath);
     if (repo) return `${repo} (main repo)`;
   }
@@ -205,32 +314,32 @@ function workspaceSettingsSourceLabel(worktreePath, repoPath) {
 // src/store/paths.ts
 function appDataDir() {
   const override = process.env.SIDEBOARD_APP_DATA?.trim();
-  const base = override ? override : process.platform === "darwin" ? join2(homedir2(), "Library", "Application Support", "sideboard") : process.platform === "win32" ? join2(process.env.APPDATA ?? join2(homedir2(), "AppData", "Roaming"), "sideboard") : join2(homedir2(), ".local", "share", "sideboard");
+  const base = override ? override : process.platform === "darwin" ? join4(homedir2(), "Library", "Application Support", "sideboard") : process.platform === "win32" ? join4(process.env.APPDATA ?? join4(homedir2(), "AppData", "Roaming"), "sideboard") : join4(homedir2(), ".local", "share", "sideboard");
   mkdirSync(base, { recursive: true });
   return base;
 }
 function threadsDir() {
-  const dir = join2(appDataDir(), "threads");
+  const dir = join4(appDataDir(), "threads");
   mkdirSync(dir, { recursive: true });
   return dir;
 }
 function locksDir() {
-  const dir = join2(appDataDir(), "locks");
+  const dir = join4(appDataDir(), "locks");
   mkdirSync(dir, { recursive: true });
   return dir;
 }
 function sideboardHomeDir() {
-  const dir = join2(homedir2(), "sideboard");
+  const dir = join4(homedir2(), "sideboard");
   mkdirSync(dir, { recursive: true });
   return dir;
 }
 function sideboardReposDir() {
-  const dir = join2(sideboardHomeDir(), "repos");
+  const dir = join4(sideboardHomeDir(), "repos");
   mkdirSync(dir, { recursive: true });
   return dir;
 }
 function sideboardWorkspacesDir() {
-  const dir = join2(sideboardHomeDir(), "workspaces");
+  const dir = join4(sideboardHomeDir(), "workspaces");
   mkdirSync(dir, { recursive: true });
   return dir;
 }
@@ -243,23 +352,25 @@ function worktreesRoot(repoPath) {
     mkdirSync(settings.worktreesRoot, { recursive: true });
     return settings.worktreesRoot;
   }
-  const dir = join2(sideboardWorkspacesDir(), repoSlug(repoPath));
+  const dir = join4(sideboardWorkspacesDir(), repoSlug(repoPath));
   mkdirSync(dir, { recursive: true });
   return dir;
 }
 function threadFilePath(id) {
-  return join2(threadsDir(), `${id}.json`);
+  return join4(threadsDir(), `${id}.json`);
 }
 function threadLockPath(id) {
-  return join2(locksDir(), `${id}.lock`);
+  return join4(locksDir(), `${id}.lock`);
 }
 function globalAgentCwd() {
-  const dir = join2(appDataDir(), "global");
+  const dir = join4(appDataDir(), "global");
   mkdirSync(dir, { recursive: true });
   return dir;
 }
 
 export {
+  findConventionSetup,
+  runCursorWorktreeSetup,
   loadRepoSettings,
   loadWorkspaceSettings,
   workspaceSettingsSourceLabel,

package/dist/{chunk-7FD7COKE.js → chunk-JOF3XIEM.js}

@@ -7,7 +7,7 @@ import {
   threadFilePath,
   threadLockPath,
   threadsDir
-} from "./chunk-7MV3RXSC.js";
+} from "./chunk-JL4SJ6V7.js";
 
 // src/store/thread-store.ts
 import { randomUUID } from "crypto";

package/dist/{chunk-KRAUS3RF.js → chunk-L63LLCTX.js}

@@ -4,13 +4,13 @@ import {
 import {
   getGithubGitAuthMode,
   getGithubPat
-} from "./chunk-I3FRXL7J.js";
+} from "./chunk-XY6XXMAK.js";
 import {
   listThreads
-} from "./chunk-FWJYLBO6.js";
+} from "./chunk-3WA37BRI.js";
 import {
   worktreesRoot
-} from "./chunk-M37RITA6.js";
+} from "./chunk-B4R2VB2A.js";
 import {
   gh,
   git,
@@ -1031,7 +1031,7 @@ function formatGitAuthModeDirective(mode) {
     default:
       return [
         "Git authentication (Account \u2192 GitHub mode: auto):",
-        "- This process rewrites GitHub SSH remotes to HTTPS and authenticates with `GH_TOKEN` from `gh` so git/ssh never prompt the macOS Keychain (required for Slack / unattended Cursor).",
+        "- This process rewrites GitHub SSH remotes to HTTPS and authenticates with `GH_TOKEN` from `gh` so git/ssh never prompt the macOS Keychain (required for unattended orchestrator turns).",
         "- Do not switch remotes to SSH. Push with `git push -u origin HEAD`.",
         "- If HTTPS auth fails, tell the user to run `gh auth login` on this Mac or set Account \u2192 GitHub to a PAT \u2014 do not wait for a Keychain dialog."
       ].join("\n");