@sideboard-ai/core 0.1.234 → 0.1.236

package/dist/{chunk-RKKTCKVX.js → chunk-6Q2CFQ4D.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-JFOPOMK7.js";
 import {
   releaseCaffeinateHoldForThread
-} from "./chunk-YWI3IBP2.js";
+} from "./chunk-DQN5U2VH.js";
 import {
   PLAN_MODE_INSTRUCTION,
   adjustBrightsyTurnExit,
@@ -42,7 +42,7 @@ import {
   summarizeTurnStderr,
   toolDescription,
   turnFailChatText
-} from "./chunk-NOIWXANG.js";
+} from "./chunk-ANGPU5JL.js";
 import {
   SLACK_REPLY_FORMATTING,
   addWorkspace,
@@ -65,7 +65,7 @@ import {
   stageAbsolutePathsAsAttachments,
   stageBuffersAsAttachments,
   syncWorkspacesFromThreads
-} from "./chunk-TWXSZYR2.js";
+} from "./chunk-RRXRLHIE.js";
 import {
   addPrStackLayer,
   allocateTeamName,
@@ -114,7 +114,7 @@ import {
   worktreeDisplayLabelForGroup,
   worktreeNameFromPath,
   worktreeSlugForTicket
-} from "./chunk-4VFOJZPS.js";
+} from "./chunk-JXZS56VW.js";
 import {
   ATTACHMENTS_DIR,
   DETACHED_JOBS_DIR,
@@ -132,7 +132,7 @@ import {
   updateThread,
   withThreadLock,
   writeThread
-} from "./chunk-XJETIO4K.js";
+} from "./chunk-NJ5OXOTN.js";
 import {
   ensureWorktreeSideboardIgnored
 } from "./chunk-DD67JWTN.js";
@@ -177,11 +177,12 @@ import {
   updateAdvancedSettings,
   usageOnLimit,
   writeSecureJson
-} from "./chunk-RZTRWN2V.js";
+} from "./chunk-4H5WO4H3.js";
 import {
   writePrivateFile
 } from "./chunk-NSTQ6QKD.js";
 import {
+  annotateDevAccessRuns,
   appDataDir,
   findConventionSetup,
   loadRepoSettings,
@@ -193,7 +194,7 @@ import {
   threadsDir,
   workspaceSettingsSourceLabel,
   worktreesRoot
-} from "./chunk-EQNRWDLN.js";
+} from "./chunk-KK63BFYN.js";
 import {
   stripNestedElectronEnv
 } from "./chunk-WWUABK6B.js";
@@ -418,7 +419,7 @@ async function continueSourceThread(threadId, prompt) {
       await continueOnReply(threadId, prompt);
       return;
     }
-    const { getOrchestrator: getOrchestrator2 } = await import("./orchestrator-7ZEGFPK4.js");
+    const { getOrchestrator: getOrchestrator2 } = await import("./orchestrator-AYPDBGIF.js");
     await getOrchestrator2().send(threadId, prompt);
   } catch {
   }
@@ -896,9 +897,9 @@ async function spawnAgentTurn(thread, input, onEvent) {
       `Cannot spawn ${thread.agent}: thread ${thread.id} has no worktreePath`
     );
   }
-  const { isGlobalThread: isGlobalThread2 } = await import("./global-workspace-7WH24UFO.js");
+  const { isGlobalThread: isGlobalThread2 } = await import("./global-workspace-3XZN3QHZ.js");
   if (isGlobalThread2(thread)) {
-    const { ensureGlobalCoordinatorCwd: ensureGlobalCoordinatorCwd2 } = await import("./coordinator-prompt-CE7MN6QY.js");
+    const { ensureGlobalCoordinatorCwd: ensureGlobalCoordinatorCwd2 } = await import("./coordinator-prompt-2BRUH7PJ.js");
     ensureGlobalCoordinatorCwd2(
       isOrchestratorThread(thread) ? { orchestratorThreadId: thread.id } : void 0
     );
@@ -3935,7 +3936,7 @@ async function createThread(input, _onSetupLine) {
   });
   await requireAgent(resolved.agent);
   if (input.cowboy) {
-    const { cowboyModeEnabled } = await import("./app-settings-KBL2G7M4.js");
+    const { cowboyModeEnabled } = await import("./app-settings-2CFCRYD7.js");
     if (!cowboyModeEnabled()) {
       throw new Error(
         "Cowboy mode is off. Enable it in Settings \u2192 Advanced."
@@ -3993,7 +3994,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-WZNDTRVL.js");
+      const { ensureAbleTimeTask, issueAttachmentForAbleTimeTask } = await import("./abletime-KOGCIQCO.js");
       const task = await ensureAbleTimeTask({
         title: title?.trim() || "Untitled work",
         description: input.prompt?.trim() || void 0
@@ -4556,7 +4557,7 @@ async function adoptThread(input) {
     messages: input.messages ?? []
   });
   writeThread(thread);
-  const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-NSQZSDQD.js");
+  const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-V7522TQH.js");
   await ensureWorkspace2(repoPath);
   const { ensureWorktreeSideboardIgnored: ensureWorktreeSideboardIgnored2 } = await import("./worktree-exclude-5N2KTYIT.js");
   await ensureWorktreeSideboardIgnored2(input.worktreePath);
@@ -6465,6 +6466,34 @@ function formatRenameBranchDirective(thread, opts) {
   }
   return lines.join("\n");
 }
+function localhostPreviewUrl(port) {
+  return `http://localhost:${port}`;
+}
+function describeLiveDevRun(run2) {
+  const url = localhostPreviewUrl(run2.port);
+  if (run2.preview === "window") {
+    return `${run2.scriptName} Electron window (renderer ${url})`;
+  }
+  return `${run2.scriptName} ${url}`;
+}
+function formatDevAccessHint(runs) {
+  const live = (runs ?? []).filter(
+    (r) => Number.isFinite(r.port) && r.port > 0
+  );
+  if (live.length === 1) {
+    const r = live[0];
+    const url = localhostPreviewUrl(r.port);
+    if (r.preview === "window") {
+      return `This worktree's Dev app is the Electron window (${r.scriptName}). Renderer origin ${url} \u2014 curl to confirm Vite; do not open it in a browser (no preload/IPC). Do not guess :3000.`;
+    }
+    return `This worktree's Dev app is ${url} (${r.scriptName}). Open that URL (browser, curl, Playwright) \u2014 do not guess :3000.`;
+  }
+  if (live.length > 1) {
+    const bits = live.map(describeLiveDevRun).join("; ");
+    return `This worktree's Dev apps: ${bits}. preview=url \u2192 open the URL; preview=window \u2192 Electron window is the app. Do not guess :3000.`;
+  }
+  return "To open the project Dev app: MCP `run_dev_script` (same as the desktop Dev button) returns `{url, port, preview}` (`SIDEBOARD_PORT`, not 3000). preview=url \u2192 open that URL (browser, curl, Playwright). preview=window \u2192 Electron: the native window is the app; url is renderer/HMR only (no preload/IPC in a browser). If already running, `list_run_scripts` `active[].url`. `stop_dev_script` to stop.";
+}
 function formatWorktreeDirective(thread, opts) {
   const worktree = normPath(thread.worktreePath);
   const repo = normPath(thread.repoPath);
@@ -6512,6 +6541,8 @@ function formatWorktreeDirective(thread, opts) {
     '- Sideboard git buttons send short phrases ("Commit and push.", "Ready for review.", "Merge PR.", \u2026) with their meaning attached \u2014 act on them without asking for clarification. If the user gives a goal (Greptile 5/5, CI green, until checks pass), you get the watch-fix-push playbook with that request.'
   );
   lines.push("");
+  lines.push(formatDevAccessHint(opts?.activeRuns));
+  lines.push("");
   lines.push(formatProcessGuideDirective({ worktreePath: thread.worktreePath }));
   return lines.join("\n");
 }
@@ -6615,12 +6646,12 @@ function formatLongRunningDirective(opts) {
     "- Hanging, no useful output, or the wrong thing \u2192 `stop_job` (or the helper with `stop <id>`). Do not stop a pack/test/deploy that is clearly making progress.",
     "- Stay in the loop until stillRunning is false (or you stopped it). ok \u2192 finish the task. failed / stopped \u2192 read the log, fix or narrow the command, start once.",
     "State: `.context/.sideboard/detached-jobs/<id>/` (local scratch). Full guide: `/long-running` (always available).",
-    "Project Dev / run scripts (`.sideboard` `[scripts.run.*]`, same as the desktop Dev button): use MCP `list_run_scripts` / `run_dev_script` / `stop_dev_script` \u2014 logs and Stop live in the thread UI. Do not detached-job or shell-spawn that same command."
+    "Project Dev / run scripts (`.sideboard` `[scripts.run.*]`, same as the desktop Dev button): use MCP `list_run_scripts` / `run_dev_script` / `stop_dev_script` \u2014 logs and Stop live in the thread UI. Do not detached-job or shell-spawn that same command. `run_dev_script` returns `{url, port, preview}` (`SIDEBOARD_PORT`). preview=url \u2192 open that URL; preview=window \u2192 Electron window is the app (url is renderer/HMR only). Never guess :3000."
   ].join("\n");
 }
 function formatLongRunningReminder(opts) {
   const invoke = formatDetachedJobInvoke(opts?.scriptPath);
-  return `Long jobs: \`${invoke} start <id> -- <cmd>\`, loop wait_for_job (or detached-job wait). The log pane updates from wait JSON; present_artifact type=log is optional. stop_job if hanging or wrong. Do not say you will let the user know later \u2014 stay in the turn. Project Dev button: list_run_scripts / run_dev_script / stop_dev_script (UI-connected \u2014 not detached-job).`;
+  return `Long jobs: \`${invoke} start <id> -- <cmd>\`, loop wait_for_job (or detached-job wait). The log pane updates from wait JSON; present_artifact type=log is optional. stop_job if hanging or wrong. Do not say you will let the user know later \u2014 stay in the turn. Project Dev button: list_run_scripts / run_dev_script / stop_dev_script (UI-connected \u2014 not detached-job). ${formatDevAccessHint(opts?.activeRuns)}`;
 }
 function formatArtifactDirective() {
   return [
@@ -6632,7 +6663,7 @@ function formatArtifactDirective() {
   ].join("\n");
 }
 function formatUiReminder() {
-  return "Sideboard UI: markdown table is enough to read data; present_schema if they ask to edit/filter (even after markdown); present_files for the file manager. html fence or present_artifact, not both for the same document. type=log appends (same artifact_id, new lines only). ask_user only for a real multiple-choice (not hellos, \u201Cwhat next?\u201D, or after a review) \u2014 reply in chat. Do not say artifacts/CMS UI are unavailable. Dev / preview: run_dev_script (same as the Dev button); stop_dev_script to stop.";
+  return "Sideboard UI: markdown table is enough to read data; present_schema if they ask to edit/filter (even after markdown); present_files for the file manager. html fence or present_artifact, not both for the same document. type=log appends (same artifact_id, new lines only). ask_user only for a real multiple-choice (not hellos, \u201Cwhat next?\u201D, or after a review) \u2014 reply in chat. Do not say artifacts/CMS UI are unavailable. Dev / preview: run_dev_script (same as the Dev button) returns {url, port, preview} (SIDEBOARD_PORT \u2014 never guess :3000). preview=url \u2192 open url; preview=window \u2192 Electron window is the app, url is renderer/HMR only. list_run_scripts active[].url if already running; stop_dev_script to stop.";
 }
 
 // src/review/review-write-gate.ts
@@ -7032,7 +7063,7 @@ function formatScheduledPrompt(name, prompt) {
 ${prompt}`;
 }
 async function defaultDeps() {
-  const { getOrchestrator: getOrchestrator2, startOrchestration: startOrchestration2 } = await import("./orchestrator-7ZEGFPK4.js");
+  const { getOrchestrator: getOrchestrator2, startOrchestration: startOrchestration2 } = await import("./orchestrator-AYPDBGIF.js");
   const orch = getOrchestrator2();
   return {
     findThread: (id) => findThreadByRef(id),
@@ -7357,7 +7388,7 @@ var Orchestrator = class {
           orphans: orphans.map((o) => ({ path: o.path, repoPath: o.repoPath }))
         });
       }
-      const { autoCleanupOrphansEnabled } = await import("./app-settings-KBL2G7M4.js");
+      const { autoCleanupOrphansEnabled } = await import("./app-settings-2CFCRYD7.js");
       if (autoCleanupOrphansEnabled() && shouldRunWorktreeCleanup() && orphans.length > 0) {
         await cleanupOrphanWorktrees({ repoPaths });
       }
@@ -7704,7 +7735,7 @@ var Orchestrator = class {
     }
     await setup;
     if (skipSetup) return;
-    const { autoRunAfterSetupEnabled } = await import("./app-settings-KBL2G7M4.js");
+    const { autoRunAfterSetupEnabled } = await import("./app-settings-2CFCRYD7.js");
     if (autoRunAfterSetupEnabled()) {
       try {
         await this.startDev(threadId);
@@ -8007,8 +8038,13 @@ var Orchestrator = class {
           SLACK_REPLY_FORMATTING
         ].join("\n") : null
       ].filter(Boolean).join("\n") : null;
+      const worktreeActiveRuns = thread.agent !== "brightsy" && !isOrchestratorThread(thread) && thread.worktreePath ? annotateDevAccessRuns(
+        mergeWorktreeActiveRuns(threadsSharingWorktree(thread.worktreePath)).activeRuns,
+        listRunScripts(thread.worktreePath, thread.repoPath),
+        thread.worktreePath
+      ) : [];
       const artifactReminder = thread.agent !== "brightsy" ? formatUiReminder() : null;
-      const longRunningReminder = thread.agent !== "brightsy" && !isOrchestratorThread(thread) ? formatLongRunningReminder() : null;
+      const longRunningReminder = thread.agent !== "brightsy" && !isOrchestratorThread(thread) ? formatLongRunningReminder({ activeRuns: worktreeActiveRuns }) : null;
       const worktreeReminder = thread.agent !== "brightsy" && !isOrchestratorThread(thread) ? formatWorktreeReminder() : null;
       const optionalServicesReminder = thread.agent !== "brightsy" && !isOrchestratorThread(thread) ? formatOptionalServicesReminder(loadAppSettings().integrations) : null;
       const issueTicket = issueTicketFromThread(thread, resolveEffectiveIssueSource());
@@ -8060,7 +8096,7 @@ var Orchestrator = class {
       }
       const isBrightsy = fresh.agent === "brightsy";
       const isOrchestration = isOrchestratorThread(fresh);
-      const { autoRenameBranchEnabled, getGithubGitAuthMode, gitBranchPrefixSetting } = await import("./app-settings-KBL2G7M4.js");
+      const { autoRenameBranchEnabled, getGithubGitAuthMode, gitBranchPrefixSetting } = await import("./app-settings-2CFCRYD7.js");
       const gitAuthMode = getGithubGitAuthMode();
       const worktreeDirective = isBrightsy || isOrchestration ? null : formatWorktreeDirective(fresh, {
         githubSlug: await withTimeout(
@@ -8068,7 +8104,14 @@ var Orchestrator = class {
           8e3,
           "resolveGithubRepoSlug"
         ).catch(() => null),
-        gitAuthMode
+        gitAuthMode,
+        activeRuns: annotateDevAccessRuns(
+          mergeWorktreeActiveRuns(
+            threadsSharingWorktree(fresh.worktreePath)
+          ).activeRuns,
+          listRunScripts(fresh.worktreePath, fresh.repoPath),
+          fresh.worktreePath
+        )
       });
       const artifactDirective = isBrightsy ? null : formatArtifactDirective();
       const longRunningDirective = isBrightsy || isOrchestration ? null : formatLongRunningDirective();
@@ -8208,7 +8251,7 @@ var Orchestrator = class {
       if (!this.stoppedTurns.has(threadId) && this.requireThread(threadId).agent === "cursor" && exitCode !== 0 && !assistantText && parts.length === 0) {
         const sessionId = result.sessionId || this.requireThread(threadId).sessionId || "";
         if (sessionId) {
-          const { recoverFinishedCursorRun } = await import("./cursor-recover-4PQAADAU.js");
+          const { recoverFinishedCursorRun } = await import("./cursor-recover-K3EBEM7M.js");
           for (let i = 0; i < 8; i++) {
             const recovered = recoverFinishedCursorRun({
               agentId: sessionId,
@@ -8650,7 +8693,8 @@ var Orchestrator = class {
     }
     return this.waitForDesktopRunScript(thread.id, request, op, scriptName);
   }
-  async waitForDesktopRunScript(threadId, request, op, scriptName) {
+  async waitForDesktopRunScript(threadId, initialRequest, op, scriptName) {
+    let request = initialRequest;
     const deadline = Date.now() + this.runScriptAdoptTimeoutMs;
     while (Date.now() < deadline) {
       const latest = readThread(threadId);
@@ -8674,6 +8718,15 @@ var Orchestrator = class {
         }
       } else if (fulfilled) {
         return null;
+      } else if (requestGone) {
+        const coversThisStop = req?.op === "stop" && (req.scriptName == null || req.scriptName === (scriptName ?? null));
+        if (req && coversThisStop) {
+          request = req;
+          continue;
+        }
+        throw new Error(
+          req?.op === "start" ? "Stop was replaced by a newer start request before desktop applied it." : "Stop was replaced by another run-script request before desktop applied it."
+        );
       }
       await new Promise((r) => setTimeout(r, 40));
     }
@@ -9281,7 +9334,7 @@ var Orchestrator = class {
     if (!titled.userSetTitle && meta.title && titled.title !== meta.title) {
       updateThread(thread.id, { title: meta.title });
     }
-    const { autoArchiveOnMergeEnabled } = await import("./app-settings-KBL2G7M4.js");
+    const { autoArchiveOnMergeEnabled } = await import("./app-settings-2CFCRYD7.js");
     const latest = this.requireThread(thread.id);
     if (!shouldAutoArchiveOnPrMerge({
       previousPrState: prevState || null,
@@ -9563,7 +9616,7 @@ var Orchestrator = class {
     this.enforceHistoryRetention();
     if (thread.repoPath && !isGlobalRepoPath(thread.repoPath)) {
       try {
-        const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-NSQZSDQD.js");
+        const { ensureWorkspace: ensureWorkspace2 } = await import("./workspaces-V7522TQH.js");
         await ensureWorkspace2(thread.repoPath);
       } catch {
       }
@@ -9590,7 +9643,7 @@ var Orchestrator = class {
           await runArchiveScript(thread.repoPath, thread.worktreePath);
         } catch {
         }
-        const { deleteBranchOnPurgeEnabled } = await import("./app-settings-KBL2G7M4.js");
+        const { deleteBranchOnPurgeEnabled } = await import("./app-settings-2CFCRYD7.js");
         const deleteBranch = opts?.deleteBranch ?? deleteBranchOnPurgeEnabled();
         await removeWorktree(thread.repoPath, thread.worktreePath, {
           deleteBranch: deleteBranch ? thread.branchName : void 0
@@ -9605,7 +9658,7 @@ var Orchestrator = class {
       throw new Error("Thread is not archived");
     }
     if (isGlobalThread(thread)) {
-      const { globalAgentCwd } = await import("./paths-C2VERLAE.js");
+      const { globalAgentCwd } = await import("./paths-LGKOG7MY.js");
       updateThread(thread.id, { worktreePath: globalAgentCwd() });
       const restored2 = setStatus(thread.id, "idle");
       this.emit({ type: "status_changed", threadId: restored2.id, status: restored2.status });
@@ -9617,7 +9670,7 @@ var Orchestrator = class {
           `Cowboy checkout missing: ${thread.worktreePath}. Re-add the project folder, then restore.`
         );
       }
-      const { createThreadWorktree: createThreadWorktree2 } = await import("./worktree-FMIX4BRV.js");
+      const { createThreadWorktree: createThreadWorktree2 } = await import("./worktree-IRALYI6A.js");
       const slug = thread.worktreePath.split("/").pop();
       const dest = thread.worktreePath;
       await withRepoGitLock(thread.repoPath, async () => {
@@ -9727,7 +9780,7 @@ async function startOrchestration(opts) {
     sourceRef: "default",
     ...createOpts
   }).catch(async () => {
-    const { resolveDefaultBranch: resolveDefaultBranch2, resolveRepoRoot: resolveRepoRoot2 } = await import("./worktree-FMIX4BRV.js");
+    const { resolveDefaultBranch: resolveDefaultBranch2, resolveRepoRoot: resolveRepoRoot2 } = await import("./worktree-IRALYI6A.js");
     const repo = await resolveRepoRoot2(repoPath);
     const def = await resolveDefaultBranch2(repo);
     return orch.createThread({
@@ -9737,7 +9790,7 @@ async function startOrchestration(opts) {
       repoPath: repo
     });
   });
-  const { updateThread: upd } = await import("./thread-store-FBK5SZ5P.js");
+  const { updateThread: upd } = await import("./thread-store-YOPKY74K.js");
   const updated = upd(thread.id, {
     sourceType: "orchestration",
     sourceRef: goal
@@ -9778,6 +9831,7 @@ export {
   assembleHomeBoard,
   HOME_BOARD_AGENT_HINT,
   readTurnLive,
+  localhostPreviewUrl,
   resolveScheduleThreadId,
   listSchedules,
   getSchedule,

package/dist/{chunk-WFUDY6PC.js → chunk-A4JGXX2F.js}

@@ -1,13 +1,13 @@
 // src/store/paths.ts
 import { basename } from "path";
 import { homedir as homedir2 } from "os";
-import { join as join4 } from "path";
+import { join as join5 } from "path";
 import { mkdirSync } from "fs";
 
 // src/hook/settings.ts
-import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
+import { existsSync as existsSync4, readFileSync as readFileSync3 } from "fs";
 import { homedir } from "os";
-import { join as join3 } from "path";
+import { join as join4 } from "path";
 import { parse as parseToml } from "smol-toml";
 
 // src/hook/convention-setup.ts
@@ -127,10 +127,133 @@ function hasCursorWorktreeSetup(worktreePath, repoPath) {
   return false;
 }
 
+// src/hook/dev-preview.ts
+import { existsSync as existsSync3, readdirSync, readFileSync as readFileSync2 } from "fs";
+import { join as join3 } from "path";
+var ELECTRON_CMD_RE = /\belectron(?:-vite|-forge|-builder|mon)?\b/i;
+var PNPM_FILTER_RE = /--filter(?:=|\s+)(?:"([^"]+)"|'([^']+)'|([^\s]+))/;
+var SKIP_DIR = /* @__PURE__ */ new Set([
+  "node_modules",
+  "dist",
+  "out",
+  "coverage",
+  ".git",
+  ".context",
+  ".next",
+  ".turbo",
+  ".output"
+]);
+function parseDevPreview(raw) {
+  return raw === "url" || raw === "window" ? raw : void 0;
+}
+function commandLooksLikeElectron(command) {
+  return ELECTRON_CMD_RE.test(command);
+}
+function pnpmFilterPackage(command) {
+  const m = command.match(PNPM_FILTER_RE);
+  return m?.[1] ?? m?.[2] ?? m?.[3] ?? null;
+}
+function readJsonObject(path) {
+  try {
+    const raw = JSON.parse(readFileSync2(path, "utf8"));
+    return raw && typeof raw === "object" && !Array.isArray(raw) ? raw : null;
+  } catch {
+    return null;
+  }
+}
+function packageLooksLikeElectron(pkg) {
+  const deps = {
+    ...pkg.dependencies,
+    ...pkg.devDependencies,
+    ...pkg.optionalDependencies
+  };
+  if (deps.electron || deps["electron-vite"] || deps["electron-builder"] || deps["@electron-forge/cli"] || deps["electron-forge"]) {
+    return true;
+  }
+  const scripts = pkg.scripts;
+  if (scripts && typeof scripts === "object") {
+    for (const value of Object.values(scripts)) {
+      if (typeof value === "string" && commandLooksLikeElectron(value)) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+function findPackageJsonByName(root, name, budget = 80) {
+  const queue = [root];
+  let seen = 0;
+  while (queue.length && seen < budget) {
+    const dir = queue.shift();
+    const pkgPath = join3(dir, "package.json");
+    if (existsSync3(pkgPath)) {
+      seen += 1;
+      const pkg = readJsonObject(pkgPath);
+      if (pkg?.name === name) return pkgPath;
+    }
+    let entries;
+    try {
+      entries = readdirSync(dir, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      if (!entry.isDirectory() || entry.isSymbolicLink() || SKIP_DIR.has(entry.name) || entry.name.startsWith(".")) {
+        continue;
+      }
+      queue.push(join3(dir, entry.name));
+    }
+  }
+  return null;
+}
+function classifyRunScriptPreview(opts) {
+  if (opts.preview === "url" || opts.preview === "window") return opts.preview;
+  if (commandLooksLikeElectron(opts.command)) return "window";
+  const root = opts.worktreePath?.trim();
+  if (!root) return "url";
+  const filter = pnpmFilterPackage(opts.command);
+  if (filter) {
+    if (filter.startsWith(".") || filter.startsWith("/")) {
+      const pkg = readJsonObject(join3(root, filter, "package.json"));
+      if (pkg && packageLooksLikeElectron(pkg)) return "window";
+    } else {
+      const found = findPackageJsonByName(root, filter);
+      if (found) {
+        const pkg = readJsonObject(found);
+        if (pkg && packageLooksLikeElectron(pkg)) return "window";
+        return "url";
+      }
+    }
+  }
+  const rootPkg = readJsonObject(join3(root, "package.json"));
+  if (rootPkg && packageLooksLikeElectron(rootPkg)) return "window";
+  return "url";
+}
+function runScriptPreview(script, worktreePath) {
+  if (!script) return "url";
+  return classifyRunScriptPreview({
+    command: script.command,
+    preview: script.preview,
+    worktreePath
+  });
+}
+function activeRunPreview(scriptName, scripts, worktreePath) {
+  return runScriptPreview(
+    scripts.find((s) => s.name === scriptName),
+    worktreePath
+  );
+}
+function annotateDevAccessRuns(runs, scripts, worktreePath) {
+  return runs.map((run) => ({
+    ...run,
+    preview: activeRunPreview(run.scriptName, scripts, worktreePath)
+  }));
+}
+
 // src/hook/settings.ts
 function expandHome(path) {
   if (path.startsWith("~/") || path === "~") {
-    return join3(homedir(), path.slice(2));
+    return join4(homedir(), path.slice(2));
   }
   return path;
 }
@@ -143,8 +266,8 @@ function parseAvailableIn(raw) {
   return out.length ? out : void 0;
 }
 function parseSettingsFile(path, source) {
-  if (!existsSync3(path)) return null;
-  const raw = readFileSync2(path, "utf8");
+  if (!existsSync4(path)) return null;
+  const raw = readFileSync3(path, "utf8");
   const data = parseToml(raw);
   const scripts = data.scripts ?? {};
   const setup = typeof scripts.setup === "string" ? scripts.setup : void 0;
@@ -182,7 +305,8 @@ function parseSettingsFile(path, source) {
           command: value.command,
           default: Boolean(value.default),
           icon: typeof value.icon === "string" ? value.icon : void 0,
-          availableIn: parseAvailableIn(value.available_in)
+          availableIn: parseAvailableIn(value.available_in),
+          preview: parseDevPreview(value.preview)
         });
       }
     }
@@ -253,15 +377,15 @@ function finalizeSettings(parsed) {
   };
 }
 function familyFiles(rootPath, source) {
-  const dir = join3(rootPath, `.${source}`);
+  const dir = join4(rootPath, `.${source}`);
   return {
-    toml: join3(dir, "settings.toml"),
-    local: join3(dir, "settings.local.toml")
+    toml: join4(dir, "settings.toml"),
+    local: join4(dir, "settings.local.toml")
   };
 }
 function familyExists(rootPath, source) {
   const files = familyFiles(rootPath, source);
-  return existsSync3(files.toml) || existsSync3(files.local);
+  return existsSync4(files.toml) || existsSync4(files.local);
 }
 function detectFamily(rootPath) {
   if (familyExists(rootPath, "sideboard")) return "sideboard";
@@ -324,10 +448,10 @@ function settingsSourceLabel(rootPath) {
   const family = detectFamily(rootPath);
   if (!family) return null;
   const files = familyFiles(rootPath, family);
-  if (existsSync3(files.toml) && existsSync3(files.local)) {
+  if (existsSync4(files.toml) && existsSync4(files.local)) {
     return `.${family}/settings.toml + local`;
   }
-  if (existsSync3(files.local)) return `.${family}/settings.local.toml`;
+  if (existsSync4(files.local)) return `.${family}/settings.local.toml`;
   return `.${family}/settings.toml`;
 }
 function workspaceSettingsSourceLabel(worktreePath, repoPath) {
@@ -362,32 +486,32 @@ function getRepoSetupInfo(worktreePath, repoPath) {
 // src/store/paths.ts
 function appDataDir() {
   const override = process.env.SIDEBOARD_APP_DATA?.trim();
-  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");
+  const base = override ? override : process.platform === "darwin" ? join5(homedir2(), "Library", "Application Support", "sideboard") : process.platform === "win32" ? join5(process.env.APPDATA ?? join5(homedir2(), "AppData", "Roaming"), "sideboard") : join5(homedir2(), ".local", "share", "sideboard");
   mkdirSync(base, { recursive: true });
   return base;
 }
 function threadsDir() {
-  const dir = join4(appDataDir(), "threads");
+  const dir = join5(appDataDir(), "threads");
   mkdirSync(dir, { recursive: true });
   return dir;
 }
 function locksDir() {
-  const dir = join4(appDataDir(), "locks");
+  const dir = join5(appDataDir(), "locks");
   mkdirSync(dir, { recursive: true });
   return dir;
 }
 function sideboardHomeDir() {
-  const dir = join4(homedir2(), "sideboard");
+  const dir = join5(homedir2(), "sideboard");
   mkdirSync(dir, { recursive: true });
   return dir;
 }
 function sideboardReposDir() {
-  const dir = join4(sideboardHomeDir(), "repos");
+  const dir = join5(sideboardHomeDir(), "repos");
   mkdirSync(dir, { recursive: true });
   return dir;
 }
 function sideboardWorkspacesDir() {
-  const dir = join4(sideboardHomeDir(), "workspaces");
+  const dir = join5(sideboardHomeDir(), "workspaces");
   mkdirSync(dir, { recursive: true });
   return dir;
 }
@@ -400,21 +524,21 @@ function worktreesRoot(repoPath) {
     mkdirSync(settings.worktreesRoot, { recursive: true });
     return settings.worktreesRoot;
   }
-  const dir = join4(sideboardWorkspacesDir(), repoSlug(repoPath));
+  const dir = join5(sideboardWorkspacesDir(), repoSlug(repoPath));
   mkdirSync(dir, { recursive: true });
   return dir;
 }
 function threadFilePath(id) {
-  return join4(threadsDir(), `${id}.json`);
+  return join5(threadsDir(), `${id}.json`);
 }
 function threadLivePath(id) {
-  return join4(threadsDir(), `${id}.live.json`);
+  return join5(threadsDir(), `${id}.live.json`);
 }
 function threadLockPath(id) {
-  return join4(locksDir(), `${id}.lock`);
+  return join5(locksDir(), `${id}.lock`);
 }
 function globalAgentCwd() {
-  const dir = join4(appDataDir(), "global");
+  const dir = join5(appDataDir(), "global");
   mkdirSync(dir, { recursive: true });
   return dir;
 }
@@ -425,6 +549,13 @@ export {
   hasConventionSetup,
   runCursorWorktreeSetup,
   hasCursorWorktreeSetup,
+  parseDevPreview,
+  commandLooksLikeElectron,
+  pnpmFilterPackage,
+  classifyRunScriptPreview,
+  runScriptPreview,
+  activeRunPreview,
+  annotateDevAccessRuns,
   loadRepoSettings,
   loadWorkspaceSettings,
   loadConductorSettings,