beads-ui 0.10.1 → 0.11.0

package/CHANGES.md

@@ -1,5 +1,14 @@
 # Changes
 
+## 0.11.0
+
+- [`fc00b87`](https://github.com/mantoni/beads-ui/commit/fc00b87cfd1b6600a9b9088a9f62c2f6e8fc919e)
+  fix(ui): harden daemon restart workspace registration (Leon Letto)
+- [`2ea0dd0`](https://github.com/mantoni/beads-ui/commit/2ea0dd08eb71625fa3ae51e64ea6501b4d058154)
+  perf(ui): reduce list latency by default sandbox bd calls (Leon Letto)
+
+_Released by [Maximilian Antoni](https://github.com/mantoni) on 2026-03-05._
+
 ## 0.10.1
 
 - [`62017f7`](https://github.com/mantoni/beads-ui/commit/62017f74fadb439c7270160ac03866d3554f36a3)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "beads-ui",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "description": "Local UI for Beads — Collaborate on issues with your coding agent.",
   "keywords": [
     "agent",

package/server/bd.js

@@ -94,7 +94,7 @@ function runBdUnlocked(args, options = {}) {
   };
 
   /** @type {string[]} */
-  const final_args = args.slice();
+  const final_args = buildBdArgs(args);
 
   return new Promise((resolve) => {
     const child = spawn(bin, final_args, spawn_opts);
@@ -151,6 +151,27 @@ function runBdUnlocked(args, options = {}) {
   });
 }
 
+/**
+ * Build final bd CLI arguments.
+ * bdui defaults to sandbox mode to avoid sync/autopush overhead on interactive
+ * UI requests. Set `BDUI_BD_SANDBOX=0` (or "false") to opt out.
+ *
+ * @param {string[]} args
+ * @returns {string[]}
+ */
+function buildBdArgs(args) {
+  const arg_set = new Set(args);
+  const raw_sandbox = String(process.env.BDUI_BD_SANDBOX || '').toLowerCase();
+  const sandbox_disabled = raw_sandbox === '0' || raw_sandbox === 'false';
+  const should_prepend_sandbox = !sandbox_disabled && !arg_set.has('--sandbox');
+
+  if (!should_prepend_sandbox) {
+    return args.slice();
+  }
+
+  return ['--sandbox', ...args];
+}
+
 /**
  * Serialize `bd` invocations.
  * Dolt embedded mode can crash when multiple `bd` processes run concurrently

package/server/cli/commands.js

@@ -10,6 +10,10 @@ import {
 } from './daemon.js';
 import { openUrl, registerWorkspaceWithServer, waitForServer } from './open.js';
 
+const STARTUP_SETTLE_MS = 200;
+const REGISTER_RETRY_ATTEMPTS = 5;
+const REGISTER_RETRY_DELAY_MS = 150;
+
 /**
  * Handle `start` command. Idempotent when already running.
  * - Spawns a detached server process, writes PID file, returns 0.
@@ -21,27 +25,17 @@ import { openUrl, registerWorkspaceWithServer, waitForServer } from './open.js';
 export async function handleStart(options) {
   // Default: do not open a browser unless explicitly requested via `open: true`.
   const should_open = options?.open === true;
+  const cwd = process.cwd();
   const existing_pid = readPidFile();
   if (existing_pid && isProcessRunning(existing_pid)) {
     // Server is already running - register this workspace dynamically
-    const cwd = process.cwd();
-    const workspace_database = resolveWorkspaceDatabase({ cwd });
-    if (
-      workspace_database.source !== 'home-default' &&
-      workspace_database.exists
-    ) {
-      const { url } = getConfig();
-      const registered = await registerWorkspaceWithServer(url, {
-        path: cwd,
-        database: workspace_database.path
-      });
-      if (registered) {
-        console.log('Workspace registered: %s', cwd);
-      }
+    const { url } = getConfig();
+    const registered = await registerCurrentWorkspace(url, cwd);
+    if (registered) {
+      console.log('Workspace registered: %s', cwd);
     }
     console.warn('Server is already running.');
     if (should_open) {
-      const { url } = getConfig();
       await openUrl(url);
     }
     return 0;
@@ -58,6 +52,7 @@ export async function handleStart(options) {
   if (options?.port) {
     process.env.PORT = String(options.port);
   }
+  const { url } = getConfig();
 
   const started = startDaemon({
     is_debug: options?.is_debug,
@@ -65,10 +60,32 @@ export async function handleStart(options) {
     port: options?.port
   });
   if (started && started.pid > 0) {
+    // Give the spawned daemon a brief moment to fail fast (for example EADDRINUSE).
+    await sleep(STARTUP_SETTLE_MS);
+
+    if (!isProcessRunning(started.pid)) {
+      removePidFile();
+
+      // If another server is already running at the configured URL, register this
+      // workspace there so it appears in the picker instead of silently missing.
+      const registered = await registerCurrentWorkspaceWithRetry(url, cwd);
+      if (registered) {
+        console.warn(
+          'Daemon exited early; registered workspace with existing server: %s',
+          cwd
+        );
+        return 0;
+      }
+      return 1;
+    }
+
+    // Register against the currently reachable server to ensure this workspace
+    // appears in the picker even when startup races with other daemons.
+    void registerCurrentWorkspaceWithRetry(url, cwd);
+
     printServerUrl();
     // Auto-open the browser once for a fresh daemon start
     if (should_open) {
-      const { url } = getConfig();
       // Wait briefly for the server to accept connections (single retry window)
       await waitForServer(url, 600);
       // Best-effort open; ignore result
@@ -80,6 +97,56 @@ export async function handleStart(options) {
   return 1;
 }
 
+/**
+ * @param {number} ms
+ * @returns {Promise<void>}
+ */
+function sleep(ms) {
+  return new Promise((resolve) => {
+    setTimeout(() => {
+      resolve();
+    }, ms);
+  });
+}
+
+/**
+ * @param {string} url
+ * @param {string} cwd
+ * @returns {Promise<boolean>}
+ */
+async function registerCurrentWorkspace(url, cwd) {
+  const workspace_database = resolveWorkspaceDatabase({ cwd });
+  if (
+    workspace_database.source === 'home-default' ||
+    !workspace_database.exists
+  ) {
+    return false;
+  }
+
+  return registerWorkspaceWithServer(url, {
+    path: cwd,
+    database: workspace_database.path
+  });
+}
+
+/**
+ * @param {string} url
+ * @param {string} cwd
+ * @returns {Promise<boolean>}
+ */
+async function registerCurrentWorkspaceWithRetry(url, cwd) {
+  for (let i = 0; i < REGISTER_RETRY_ATTEMPTS; i++) {
+    const registered = await registerCurrentWorkspace(url, cwd);
+    if (registered) {
+      return true;
+    }
+    if (i < REGISTER_RETRY_ATTEMPTS - 1) {
+      await sleep(REGISTER_RETRY_DELAY_MS);
+    }
+  }
+  return false;
+}
+
 /**
  * Handle `stop` command.
  * - Sends SIGTERM and waits for exit (with SIGKILL fallback), removes PID file.