@staff0rd/assist 0.244.2 → 0.245.1

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.244.2",
+  version: "0.245.1",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -3632,15 +3632,15 @@ Phase ${phaseNumber} completed.`));
 
 // src/commands/backlog/watchForMarker.ts
 import { existsSync as existsSync20, unwatchFile, watchFile } from "fs";
-function watchForMarker(child) {
+function watchForMarker(child, options2) {
   const statusPath = getSignalPath();
   watchFile(statusPath, { interval: 1e3 }, () => {
     if (!existsSync20(statusPath)) return;
     const signal = readSignal();
-    if (signal) {
-      unwatchFile(statusPath);
-      child.kill("SIGTERM");
-    }
+    if (!signal) return;
+    if (signal.event === "done" && !options2?.actOnDone) return;
+    unwatchFile(statusPath);
+    child.kill("SIGTERM");
   });
 }
 function stopWatching() {
@@ -3809,7 +3809,7 @@ async function next(options2, startId) {
     firstPick = false;
     if (id === void 0) return;
     const completed = await run2(id, options2);
-    if (!completed) return;
+    if (!completed || options2?.once) return;
   }
 }
 
@@ -4098,7 +4098,14 @@ function startWebServer(label2, port, handler, initialPath) {
 
 // src/commands/sessions/daemon/ensureDaemonRunning.ts
 import { spawn as spawn4 } from "child_process";
-import { mkdirSync as mkdirSync4, openSync } from "fs";
+import {
+  closeSync,
+  mkdirSync as mkdirSync4,
+  openSync,
+  statSync,
+  unlinkSync as unlinkSync4,
+  writeSync
+} from "fs";
 
 // src/commands/sessions/daemon/connectToDaemon.ts
 import * as net from "net";
@@ -4111,7 +4118,8 @@ var daemonPaths = {
   dir: DAEMON_DIR,
   socket: process.platform === "win32" ? "\\\\.\\pipe\\assist-sessions-daemon" : join15(DAEMON_DIR, "daemon.sock"),
   log: join15(DAEMON_DIR, "daemon.log"),
-  pid: join15(DAEMON_DIR, "daemon.pid")
+  pid: join15(DAEMON_DIR, "daemon.pid"),
+  spawnLock: join15(DAEMON_DIR, "spawn.lock")
 };
 
 // src/commands/sessions/daemon/connectToDaemon.ts
@@ -4134,9 +4142,19 @@ async function isDaemonRunning() {
 // src/commands/sessions/daemon/ensureDaemonRunning.ts
 var SPAWN_TIMEOUT_MS = 1e4;
 var RETRY_DELAY_MS = 200;
-async function ensureDaemonRunning() {
+var STALE_LOCK_MS = SPAWN_TIMEOUT_MS + 5e3;
+async function ensureDaemonRunning(reason = "unspecified") {
   if (await isDaemonRunning()) return;
-  spawnDaemon();
+  mkdirSync4(daemonPaths.dir, { recursive: true });
+  const holdsLock = acquireSpawnLock();
+  if (holdsLock) spawnDaemon(reason);
+  try {
+    await waitForDaemon();
+  } finally {
+    if (holdsLock) releaseSpawnLock();
+  }
+}
+async function waitForDaemon() {
   const deadline = Date.now() + SPAWN_TIMEOUT_MS;
   while (Date.now() < deadline) {
     await delay(RETRY_DELAY_MS);
@@ -4146,12 +4164,44 @@ async function ensureDaemonRunning() {
     `Sessions daemon did not start within ${SPAWN_TIMEOUT_MS / 1e3}s; see ${daemonPaths.log}`
   );
 }
-function spawnDaemon() {
-  mkdirSync4(daemonPaths.dir, { recursive: true });
+function acquireSpawnLock() {
+  if (tryCreateLock()) return true;
+  if (!isLockStale()) return false;
+  try {
+    unlinkSync4(daemonPaths.spawnLock);
+  } catch {
+  }
+  return tryCreateLock();
+}
+function tryCreateLock() {
+  try {
+    const fd = openSync(daemonPaths.spawnLock, "wx");
+    writeSync(fd, String(process.pid));
+    closeSync(fd);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function isLockStale() {
+  try {
+    return Date.now() - statSync(daemonPaths.spawnLock).mtimeMs > STALE_LOCK_MS;
+  } catch {
+    return true;
+  }
+}
+function releaseSpawnLock() {
+  try {
+    unlinkSync4(daemonPaths.spawnLock);
+  } catch {
+  }
+}
+function spawnDaemon(reason) {
   const log = openSync(daemonPaths.log, "a");
   const child = spawn4(process.execPath, [process.argv[1], "daemon", "run"], {
     detached: true,
-    stdio: ["ignore", log, log]
+    stdio: ["ignore", log, log],
+    env: { ...process.env, ASSIST_DAEMON_SPAWN_REASON: reason }
   });
   child.unref();
 }
@@ -4500,7 +4550,7 @@ function handleSocket(ws, ctx) {
 }
 async function openDaemonConnection(ws, ctx) {
   try {
-    await ensureDaemonRunning();
+    await ensureDaemonRunning("web socket connection");
     const conn = await connectToDaemon();
     relayDaemonLines(conn, ws, ctx.repoCwd);
     return conn;
@@ -4554,7 +4604,7 @@ function withRepoCwd(line, repoCwd) {
 
 // src/commands/sessions/web/index.ts
 async function web(options2) {
-  await ensureDaemonRunning();
+  await ensureDaemonRunning("web server start");
   const port = Number.parseInt(options2.port, 10);
   const server = startWebServer(
     "Assist",
@@ -4584,117 +4634,27 @@ async function web2(options2) {
   await web({ port: options2.port, initialPath: "/backlog" });
 }
 
-// src/commands/backlog/refine.ts
-import chalk47 from "chalk";
-import enquirer6 from "enquirer";
-
-// src/commands/backlog/launchMode.ts
-import chalk46 from "chalk";
-
-// src/commands/backlog/tryRunById.ts
-import chalk45 from "chalk";
-async function tryRunById(id, options2) {
-  const items2 = await loadBacklog();
-  const numericId = Number.parseInt(id, 10);
-  const item = Number.isNaN(numericId) ? void 0 : items2.find((i) => i.id === numericId);
-  if (!item) {
-    console.log(chalk45.red(`Item #${id} not found.`));
-    return false;
-  }
-  if (item.status === "done") {
-    console.log(chalk45.red(`Item #${id} is already done.`));
-    return false;
-  }
-  if (item.status === "wontdo") {
-    console.log(chalk45.red(`Item #${id} is marked won't do.`));
-    return false;
-  }
-  if (isBlocked(item, items2)) {
-    console.log(
-      chalk45.red(`Item #${id} is blocked by unresolved dependencies.`)
-    );
-    return false;
-  }
-  console.log(chalk45.bold(`
-Running backlog item #${id}...
-`));
-  await run2(id, options2);
-  return true;
-}
-
-// src/commands/backlog/launchMode.ts
-async function launchMode(slashCommand) {
-  pullIfConfigured();
-  process.env.ASSIST_SESSION_ID = String(process.pid);
-  const { child, done: done2 } = spawnClaude(`/${slashCommand}`, { allowEdits: true });
-  watchForMarker(child);
-  await done2;
-  stopWatching();
-  const signal = readSignal();
-  cleanupSignal();
-  if (signal?.event === "next") {
-    if (typeof signal.id === "string" && signal.id) {
-      if (await tryRunById(signal.id, { allowEdits: true })) return;
-    }
-    console.log(chalk46.bold("\nChaining into assist next...\n"));
-    await next({ allowEdits: true });
-  }
-}
-
-// src/commands/backlog/refine.ts
-async function pickItemForRefine() {
-  const items2 = await loadBacklog();
-  const active = items2.filter(
-    (i) => i.status === "todo" || i.status === "in-progress"
-  );
-  if (active.length === 0) {
-    console.log(chalk47.yellow("No active backlog items to refine."));
-    return void 0;
-  }
-  if (active.length === 1) {
-    const item = active[0];
-    console.log(chalk47.bold(`Auto-selecting item #${item.id}: ${item.name}`));
-    return String(item.id);
-  }
-  const { selected } = await exitOnCancel(
-    enquirer6.prompt({
-      type: "select",
-      name: "selected",
-      message: "Choose a backlog item to refine:",
-      choices: active.map((item) => ({
-        name: `${typeLabel(item.type)} #${item.id}: ${item.name}`
-      }))
-    })
-  );
-  return selected.match(/#(\d+)/)?.[1] ?? "";
-}
-async function refine(id) {
-  const itemId = id ?? await pickItemForRefine();
-  if (!itemId) return;
-  await launchMode(`refine ${itemId}`);
-}
-
 // src/commands/backlog/comment/index.ts
-import chalk48 from "chalk";
+import chalk45 from "chalk";
 async function comment(id, text2) {
   const found = await findOneItem(id);
   if (!found) process.exit(1);
   await appendComment(found.orm, found.item.id, text2);
-  console.log(chalk48.green(`Comment added to item #${id}.`));
+  console.log(chalk45.green(`Comment added to item #${id}.`));
 }
 
 // src/commands/backlog/comments/index.ts
-import chalk49 from "chalk";
+import chalk46 from "chalk";
 async function comments2(id) {
   const found = await findOneItem(id);
   if (!found) process.exit(1);
   const { item } = found;
   const entries = item.comments ?? [];
   if (entries.length === 0) {
-    console.log(chalk49.dim(`No comments on item #${id}.`));
+    console.log(chalk46.dim(`No comments on item #${id}.`));
     return;
   }
-  console.log(chalk49.bold(`Comments for #${id}: ${item.name}
+  console.log(chalk46.bold(`Comments for #${id}: ${item.name}
 `));
   for (const entry of entries) {
     console.log(`${formatComment(entry)}
@@ -4703,7 +4663,7 @@ async function comments2(id) {
 }
 
 // src/commands/backlog/delete-comment/index.ts
-import chalk50 from "chalk";
+import chalk47 from "chalk";
 async function deleteCommentCmd(id, commentId) {
   const found = await findOneItem(id);
   if (!found) process.exit(1);
@@ -4715,16 +4675,16 @@ async function deleteCommentCmd(id, commentId) {
   switch (outcome) {
     case "deleted":
       console.log(
-        chalk50.green(`Comment #${commentId} deleted from item #${id}.`)
+        chalk47.green(`Comment #${commentId} deleted from item #${id}.`)
       );
       break;
     case "not-found":
-      console.log(chalk50.red(`Comment #${commentId} not found on item #${id}.`));
+      console.log(chalk47.red(`Comment #${commentId} not found on item #${id}.`));
       process.exit(1);
       break;
     case "is-summary":
       console.log(
-        chalk50.red(
+        chalk47.red(
           `Comment #${commentId} is a phase summary and cannot be deleted.`
         )
       );
@@ -4742,7 +4702,7 @@ function registerCommentCommands(cmd) {
 
 // src/commands/backlog/export/index.ts
 import { writeFile } from "fs/promises";
-import chalk51 from "chalk";
+import chalk48 from "chalk";
 
 // src/commands/backlog/dump/DumpTable.ts
 var DUMP_FORMAT = "assist-backlog-dump";
@@ -4809,7 +4769,7 @@ async function exportBacklog(file) {
   if (file) {
     await writeFile(file, dump);
     console.error(
-      chalk51.green(`Exported backlog to ${file} (${dump.length} bytes).`)
+      chalk48.green(`Exported backlog to ${file} (${dump.length} bytes).`)
     );
     return;
   }
@@ -4825,7 +4785,7 @@ function registerExportCommand(cmd) {
 
 // src/commands/backlog/import/index.ts
 import { readFile } from "fs/promises";
-import chalk53 from "chalk";
+import chalk50 from "chalk";
 
 // src/commands/backlog/dump/countCopyRows.ts
 function countCopyRows(data) {
@@ -4902,7 +4862,7 @@ function validateDump({ header, sections }) {
 }
 
 // src/commands/backlog/import/confirmReplace.ts
-import chalk52 from "chalk";
+import chalk49 from "chalk";
 async function countRows(client, table) {
   const { rows } = await client.query(
     `SELECT count(*)::int AS n FROM ${table}`
@@ -4913,7 +4873,7 @@ function printSummary(current, incoming) {
   const lines = DUMP_TABLES.map(
     (t, i) => `  ${t.name}: ${current[i]} \u2192 ${incoming[i]} rows`
   );
-  console.error(chalk52.bold("\nThis will REPLACE all backlog data:"));
+  console.error(chalk49.bold("\nThis will REPLACE all backlog data:"));
   console.error(`${lines.join("\n")}
 `);
 }
@@ -4989,13 +4949,13 @@ async function importBacklog(file, options2 = {}) {
   );
   await withBacklogClient(async (client) => {
     if (!options2.yes && !await confirmReplace(client, incoming, !file)) {
-      console.error(chalk53.yellow("Import cancelled; no changes made."));
+      console.error(chalk50.yellow("Import cancelled; no changes made."));
       return;
     }
     await restore(client, parsed);
     const total = incoming.reduce((sum, n) => sum + n, 0);
     console.error(
-      chalk53.green(
+      chalk50.green(
         `Imported backlog: ${total} rows restored across ${DUMP_TABLES.length} tables.`
       )
     );
@@ -5012,16 +4972,16 @@ function registerImportCommand(cmd) {
 }
 
 // src/commands/backlog/add/index.ts
-import chalk54 from "chalk";
+import chalk51 from "chalk";
 
 // src/commands/backlog/add/shared.ts
 import { spawnSync } from "child_process";
-import { mkdtempSync, readFileSync as readFileSync14, unlinkSync as unlinkSync4, writeFileSync as writeFileSync13 } from "fs";
+import { mkdtempSync, readFileSync as readFileSync14, unlinkSync as unlinkSync5, writeFileSync as writeFileSync13 } from "fs";
 import { tmpdir } from "os";
 import { join as join17 } from "path";
-import enquirer7 from "enquirer";
+import enquirer6 from "enquirer";
 async function promptType() {
-  const { type } = await enquirer7.prompt({
+  const { type } = await enquirer6.prompt({
     type: "select",
     name: "type",
     message: "Type:",
@@ -5031,7 +4991,7 @@ async function promptType() {
   return type;
 }
 async function promptName() {
-  const { name } = await enquirer7.prompt({
+  const { name } = await enquirer6.prompt({
     type: "input",
     name: "name",
     message: "Name:",
@@ -5040,14 +5000,14 @@ async function promptName() {
   return name.trim();
 }
 async function promptDescription() {
-  const { useEditor } = await enquirer7.prompt({
+  const { useEditor } = await enquirer6.prompt({
     type: "confirm",
     name: "useEditor",
     message: "Open editor for description?",
     initial: false
   });
   if (!useEditor) {
-    const { description } = await enquirer7.prompt({
+    const { description } = await enquirer6.prompt({
       type: "input",
       name: "description",
       message: "Description (optional):"
@@ -5063,17 +5023,17 @@ function openEditor() {
   writeFileSync13(filePath, "");
   const result = spawnSync(editor, [filePath], { stdio: "inherit" });
   if (result.status !== 0) {
-    unlinkSync4(filePath);
+    unlinkSync5(filePath);
     return void 0;
   }
   const content = readFileSync14(filePath, "utf-8").trim();
-  unlinkSync4(filePath);
+  unlinkSync5(filePath);
   return content || void 0;
 }
 async function promptAcceptanceCriteria() {
   const criteria = [];
   for (; ; ) {
-    const { criterion } = await enquirer7.prompt({
+    const { criterion } = await enquirer6.prompt({
       type: "input",
       name: "criterion",
       message: "Acceptance criterion (empty to finish):"
@@ -5102,11 +5062,11 @@ async function add(options2) {
     },
     getOrigin()
   );
-  console.log(chalk54.green(`Added item #${id}: ${name}`));
+  console.log(chalk51.green(`Added item #${id}: ${name}`));
 }
 
 // src/commands/backlog/addPhase.ts
-import chalk56 from "chalk";
+import chalk53 from "chalk";
 
 // src/commands/backlog/insertPhaseAt.ts
 import { count, eq as eq14 } from "drizzle-orm";
@@ -5139,7 +5099,7 @@ async function insertPhaseAt(orm, itemId, phaseIdx, name, tasks, manualChecks, c
 }
 
 // src/commands/backlog/resolveInsertPosition.ts
-import chalk55 from "chalk";
+import chalk52 from "chalk";
 import { count as count2, eq as eq15 } from "drizzle-orm";
 async function resolveInsertPosition(orm, itemId, position) {
   const [row] = await orm.select({ cnt: count2() }).from(planPhases).where(eq15(planPhases.itemId, itemId));
@@ -5148,7 +5108,7 @@ async function resolveInsertPosition(orm, itemId, position) {
   const pos = Number.parseInt(position, 10);
   if (pos < 1 || pos > phaseCount + 1) {
     console.log(
-      chalk55.red(
+      chalk52.red(
         `Position ${pos} is out of range. Must be between 1 and ${phaseCount + 1}.`
       )
     );
@@ -5169,7 +5129,7 @@ async function addPhase(id, name, options2) {
   if (!found) return;
   const tasks = options2.task ?? [];
   if (tasks.length === 0) {
-    console.log(chalk56.red("At least one --task is required."));
+    console.log(chalk53.red("At least one --task is required."));
     process.exitCode = 1;
     return;
   }
@@ -5188,14 +5148,14 @@ async function addPhase(id, name, options2) {
   );
   const verb = options2.position !== void 0 ? "Inserted" : "Added";
   console.log(
-    chalk56.green(
+    chalk53.green(
       `${verb} phase ${phaseIdx + 1} "${name}" to item #${itemId} with ${tasks.length} task(s).`
     )
   );
 }
 
 // src/commands/backlog/list/index.ts
-import chalk57 from "chalk";
+import chalk54 from "chalk";
 
 // src/commands/backlog/originDisplayName.ts
 function originDisplayName(origin) {
@@ -5247,7 +5207,7 @@ async function list2(options2) {
   const allItems = await loadBacklog(options2.allRepos);
   const items2 = filterItems(allItems, options2);
   if (items2.length === 0) {
-    console.log(chalk57.dim("Backlog is empty."));
+    console.log(chalk54.dim("Backlog is empty."));
     return;
   }
   const labels = originDisplayLabels(
@@ -5256,9 +5216,9 @@ async function list2(options2) {
   const repoNameOf = (item) => item.origin ? labels.get(item.origin) ?? "" : "";
   const prefixWidth = options2.allRepos ? Math.max(0, ...items2.map((i) => repoNameOf(i).length)) : 0;
   for (const item of items2) {
-    const repoPrefix2 = options2.allRepos ? `${chalk57.dim(repoNameOf(item).padEnd(prefixWidth))} ` : "";
+    const repoPrefix2 = options2.allRepos ? `${chalk54.dim(repoNameOf(item).padEnd(prefixWidth))} ` : "";
     console.log(
-      `${repoPrefix2}${statusIcon(item.status)} ${typeLabel(item.type)} ${chalk57.dim(`#${item.id}`)} ${item.name}${phaseLabel(item)}${dependencyLabel(item, allItems)}`
+      `${repoPrefix2}${statusIcon(item.status)} ${typeLabel(item.type)} ${chalk54.dim(`#${item.id}`)} ${item.name}${phaseLabel(item)}${dependencyLabel(item, allItems)}`
     );
     if (options2.verbose) {
       printVerboseDetails(item);
@@ -5284,7 +5244,7 @@ function registerItemCommands(cmd) {
 }
 
 // src/commands/backlog/link.ts
-import chalk59 from "chalk";
+import chalk56 from "chalk";
 
 // src/commands/backlog/hasCycle.ts
 function hasCycle(adjacency, fromId, toId) {
@@ -5316,14 +5276,14 @@ async function loadDependencyGraph(orm) {
 }
 
 // src/commands/backlog/validateLinkTarget.ts
-import chalk58 from "chalk";
+import chalk55 from "chalk";
 function validateLinkTarget(fromItem, fromNum, toNum, linkType) {
   const duplicate = (fromItem.links ?? []).some(
     (l) => l.targetId === toNum && l.type === linkType
   );
   if (duplicate) {
     console.log(
-      chalk58.yellow(`Link already exists: #${fromNum} ${linkType} #${toNum}`)
+      chalk55.yellow(`Link already exists: #${fromNum} ${linkType} #${toNum}`)
     );
     return false;
   }
@@ -5332,7 +5292,7 @@ function validateLinkTarget(fromItem, fromNum, toNum, linkType) {
 
 // src/commands/backlog/link.ts
 function fail(message) {
-  console.log(chalk59.red(message));
+  console.log(chalk56.red(message));
   return void 0;
 }
 function parseLinkType(type) {
@@ -5362,12 +5322,12 @@ async function link(fromId, toId, opts) {
   if (await createsCycle(orm, linkType, fromNum, toNum)) return;
   await orm.insert(links).values({ itemId: fromNum, type: linkType, targetId: toNum });
   console.log(
-    chalk59.green(`Linked #${fromNum} ${linkType} #${toNum} (${toItem.name})`)
+    chalk56.green(`Linked #${fromNum} ${linkType} #${toNum} (${toItem.name})`)
   );
 }
 
 // src/commands/backlog/unlink.ts
-import chalk60 from "chalk";
+import chalk57 from "chalk";
 import { and as and4, eq as eq17 } from "drizzle-orm";
 async function unlink(fromId, toId) {
   const fromNum = Number.parseInt(fromId, 10);
@@ -5375,19 +5335,19 @@ async function unlink(fromId, toId) {
   const { orm } = await getReady();
   const fromItem = await loadItem(orm, fromNum);
   if (!fromItem) {
-    console.log(chalk60.red(`Item #${fromId} not found.`));
+    console.log(chalk57.red(`Item #${fromId} not found.`));
     return;
   }
   if (!fromItem.links || fromItem.links.length === 0) {
-    console.log(chalk60.yellow(`No links found on item #${fromId}.`));
+    console.log(chalk57.yellow(`No links found on item #${fromId}.`));
     return;
   }
   if (!fromItem.links.some((l) => l.targetId === toNum)) {
-    console.log(chalk60.yellow(`No link from #${fromId} to #${toId} found.`));
+    console.log(chalk57.yellow(`No link from #${fromId} to #${toId} found.`));
     return;
   }
   await orm.delete(links).where(and4(eq17(links.itemId, fromNum), eq17(links.targetId, toNum)));
-  console.log(chalk60.green(`Removed link from #${fromId} to #${toId}.`));
+  console.log(chalk57.green(`Removed link from #${fromId} to #${toId}.`));
 }
 
 // src/commands/backlog/registerLinkCommands.ts
@@ -5401,17 +5361,17 @@ function registerLinkCommands(cmd) {
 }
 
 // src/commands/backlog/move-repo/index.ts
-import chalk62 from "chalk";
+import chalk59 from "chalk";
 import { eq as eq19 } from "drizzle-orm";
 
 // src/commands/backlog/move-repo/confirmMove.ts
-import chalk61 from "chalk";
+import chalk58 from "chalk";
 function pluralItems(n) {
   return `${n} item${n === 1 ? "" : "s"}`;
 }
 async function confirmMove(cnt, oldOrigin, newOrigin) {
   console.log(
-    `${pluralItems(cnt)}: ${chalk61.cyan(oldOrigin)} \u2192 ${chalk61.cyan(newOrigin)}`
+    `${pluralItems(cnt)}: ${chalk58.cyan(oldOrigin)} \u2192 ${chalk58.cyan(newOrigin)}`
   );
   return promptConfirm(`Retag ${pluralItems(cnt)}?`);
 }
@@ -5443,7 +5403,7 @@ Pass the full origin.`
 
 // src/commands/backlog/move-repo/index.ts
 function fail2(message) {
-  console.log(chalk62.red(message));
+  console.log(chalk59.red(message));
   process.exitCode = 1;
 }
 async function moveRepo(oldOriginRaw, newOriginRaw, options2 = {}) {
@@ -5459,12 +5419,12 @@ async function moveRepo(oldOriginRaw, newOriginRaw, options2 = {}) {
   }
   const cnt = await countByOrigin(orm, oldOrigin);
   if (!options2.yes && !await confirmMove(cnt, oldOrigin, newOrigin)) {
-    console.log(chalk62.yellow("Move cancelled; no changes made."));
+    console.log(chalk59.yellow("Move cancelled; no changes made."));
     return;
   }
   await orm.update(items).set({ origin: newOrigin }).where(eq19(items.origin, oldOrigin));
   console.log(
-    chalk62.green(
+    chalk59.green(
       `Moved ${pluralItems(cnt)} from "${oldOrigin}" to "${newOrigin}".`
     )
   );
@@ -5479,12 +5439,116 @@ function registerMoveRepoCommand(cmd) {
   );
 }
 
+// src/commands/backlog/registerNextCommand.ts
+function registerNextCommand(cmd) {
+  cmd.command("next").argument("[id]", "Backlog item ID to run first").description("Pick and run the next backlog item, or open /draft if none").option("-w, --write", "Run Claude with auto permission mode (default)").option("--no-write", "Run Claude without auto permission mode").option("--once", "Exit after the first completed item run").action(
+    (id, opts) => next({ allowEdits: opts.write !== false, once: opts.once }, id)
+  );
+}
+
 // src/commands/backlog/registerPlanCommands.ts
 function registerPlanCommands(cmd) {
   cmd.command("plan <id>").description("Display the plan for a backlog item").action(plan);
   cmd.command("phase-done <id> <phase> <summary>").description("Signal that a plan phase is complete").action(phaseDone);
 }
 
+// src/commands/backlog/refine.ts
+import chalk62 from "chalk";
+import enquirer7 from "enquirer";
+
+// src/commands/backlog/launchMode.ts
+import chalk61 from "chalk";
+
+// src/commands/backlog/tryRunById.ts
+import chalk60 from "chalk";
+async function tryRunById(id, options2) {
+  const items2 = await loadBacklog();
+  const numericId = Number.parseInt(id, 10);
+  const item = Number.isNaN(numericId) ? void 0 : items2.find((i) => i.id === numericId);
+  if (!item) {
+    console.log(chalk60.red(`Item #${id} not found.`));
+    return false;
+  }
+  if (item.status === "done") {
+    console.log(chalk60.red(`Item #${id} is already done.`));
+    return false;
+  }
+  if (item.status === "wontdo") {
+    console.log(chalk60.red(`Item #${id} is marked won't do.`));
+    return false;
+  }
+  if (isBlocked(item, items2)) {
+    console.log(
+      chalk60.red(`Item #${id} is blocked by unresolved dependencies.`)
+    );
+    return false;
+  }
+  console.log(chalk60.bold(`
+Running backlog item #${id}...
+`));
+  await run2(id, options2);
+  return true;
+}
+
+// src/commands/backlog/launchMode.ts
+async function launchMode(slashCommand, options2) {
+  pullIfConfigured();
+  process.env.ASSIST_SESSION_ID = String(process.pid);
+  const { child, done: done2 } = spawnClaude(`/${slashCommand}`, { allowEdits: true });
+  watchForMarker(child, { actOnDone: options2?.once });
+  await done2;
+  stopWatching();
+  const signal = readSignal();
+  cleanupSignal();
+  if (signal?.event === "next") {
+    if (typeof signal.id === "string" && signal.id) {
+      if (await tryRunById(signal.id, { allowEdits: true })) return;
+    }
+    console.log(chalk61.bold("\nChaining into assist next...\n"));
+    await next({ allowEdits: true, once: options2?.once });
+  }
+}
+
+// src/commands/backlog/refine.ts
+async function pickItemForRefine() {
+  const items2 = await loadBacklog();
+  const active = items2.filter(
+    (i) => i.status === "todo" || i.status === "in-progress"
+  );
+  if (active.length === 0) {
+    console.log(chalk62.yellow("No active backlog items to refine."));
+    return void 0;
+  }
+  if (active.length === 1) {
+    const item = active[0];
+    console.log(chalk62.bold(`Auto-selecting item #${item.id}: ${item.name}`));
+    return String(item.id);
+  }
+  const { selected } = await exitOnCancel(
+    enquirer7.prompt({
+      type: "select",
+      name: "selected",
+      message: "Choose a backlog item to refine:",
+      choices: active.map((item) => ({
+        name: `${typeLabel(item.type)} #${item.id}: ${item.name}`
+      }))
+    })
+  );
+  return selected.match(/#(\d+)/)?.[1] ?? "";
+}
+async function refine(id, options2) {
+  const itemId = id ?? await pickItemForRefine();
+  if (!itemId) return;
+  await launchMode(`refine ${itemId}`, options2);
+}
+
+// src/commands/backlog/registerRefineCommand.ts
+function registerRefineCommand(cmd) {
+  cmd.command("refine").argument("[id]", "Backlog item ID").description("Alias for refine").option("--once", "Exit when the initial task completes").action(
+    (id, opts) => refine(id, { once: opts.once })
+  );
+}
+
 // src/commands/backlog/rewindPhase.ts
 import chalk63 from "chalk";
 function validateRewind2(item, phaseNumber) {
@@ -6021,14 +6085,6 @@ function registerShowCommands(cmd) {
 function registerWebCommand(cmd) {
   cmd.command("web").description("Open the backlog tab in the web dashboard").option("-p, --port <number>", "Port to listen on", "3100").action(web2);
 }
-function registerRefineCommand(cmd) {
-  cmd.command("refine").argument("[id]", "Backlog item ID").description("Alias for refine").action((id) => refine(id));
-}
-function registerNextCommand(cmd) {
-  cmd.command("next").argument("[id]", "Backlog item ID to run first").description("Pick and run the next backlog item, or open /draft if none").option("-w, --write", "Run Claude with auto permission mode (default)").option("--no-write", "Run Claude without auto permission mode").action(
-    (id, opts) => next({ allowEdits: opts.write !== false }, id)
-  );
-}
 var registrars = [
   registerItemCommands,
   registerShowCommands,
@@ -8300,7 +8356,7 @@ function registerDevlog(program2) {
 }
 
 // src/commands/dotnet/checkBuildLocks.ts
-import { closeSync, openSync as openSync2, readdirSync as readdirSync2 } from "fs";
+import { closeSync as closeSync2, openSync as openSync2, readdirSync as readdirSync2 } from "fs";
 import { join as join25 } from "path";
 import chalk95 from "chalk";
 
@@ -8332,7 +8388,7 @@ function isLockedDll(debugDir) {
     const dllPath = join25(debugDir, file);
     try {
       const fd = openSync2(dllPath, "r+");
-      closeSync(fd);
+      closeSync2(fd);
     } catch {
       return dllPath;
     }
@@ -8422,7 +8478,7 @@ function collectAllDeps(node) {
 }
 
 // src/commands/dotnet/findContainingSolutions.ts
-import { readdirSync as readdirSync3, readFileSync as readFileSync22, statSync } from "fs";
+import { readdirSync as readdirSync3, readFileSync as readFileSync22, statSync as statSync2 } from "fs";
 import path22 from "path";
 function findSlnFiles(dir, maxDepth, depth = 0) {
   if (depth > maxDepth) return [];
@@ -8438,7 +8494,7 @@ function findSlnFiles(dir, maxDepth, depth = 0) {
       continue;
     const full = path22.join(dir, entry);
     try {
-      const stat = statSync(full);
+      const stat = statSync2(full);
       if (stat.isFile() && entry.endsWith(".sln")) {
         results.push(full);
       } else if (stat.isDirectory()) {
@@ -8775,7 +8831,7 @@ function parseInspectReport(json) {
 
 // src/commands/dotnet/runInspectCode.ts
 import { execSync as execSync24 } from "child_process";
-import { existsSync as existsSync29, readFileSync as readFileSync23, unlinkSync as unlinkSync5 } from "fs";
+import { existsSync as existsSync29, readFileSync as readFileSync23, unlinkSync as unlinkSync6 } from "fs";
 import { tmpdir as tmpdir3 } from "os";
 import path25 from "path";
 import chalk102 from "chalk";
@@ -8811,7 +8867,7 @@ function runInspectCode(slnPath, include, swea) {
     process.exit(1);
   }
   const xml = readFileSync23(reportPath, "utf-8");
-  unlinkSync5(reportPath);
+  unlinkSync6(reportPath);
   return xml;
 }
 
@@ -8937,7 +8993,7 @@ function aggregateCommitters(authorLists) {
 
 // src/shared/runGhGraphql.ts
 import { spawnSync as spawnSync2 } from "child_process";
-import { unlinkSync as unlinkSync6, writeFileSync as writeFileSync18 } from "fs";
+import { unlinkSync as unlinkSync7, writeFileSync as writeFileSync18 } from "fs";
 import { tmpdir as tmpdir4 } from "os";
 import { join as join27 } from "path";
 function buildArgs(queryFile, vars) {
@@ -8958,7 +9014,7 @@ function runGhGraphql(mutation, vars) {
     if (result.status !== 0) throw new Error(result.stderr || result.stdout);
     return result.stdout;
   } finally {
-    unlinkSync6(queryFile);
+    unlinkSync7(queryFile);
   }
 }
 
@@ -9598,13 +9654,21 @@ async function reviewComments(number) {
 
 // src/commands/registerLaunch.ts
 function registerLaunch(program2) {
-  program2.command("next").argument("[id]", "Backlog item ID to run first").description("Alias for backlog next").action((id) => next({ allowEdits: true }, id));
+  program2.command("next").argument("[id]", "Backlog item ID to run first").description("Alias for backlog next").option("--once", "Exit after the first completed item run").action(
+    (id, opts) => next({ allowEdits: true, once: opts.once }, id)
+  );
   program2.command("draft").alias("feat").description(
     "Launch Claude in /draft mode, chain into next on /next signal"
-  ).action(() => launchMode("draft"));
-  program2.command("bug").description("Launch Claude in /bug mode, chain into next on /next signal").action(() => launchMode("bug"));
+  ).option("--once", "Exit when the initial task completes").action(
+    (opts) => launchMode("draft", { once: opts.once })
+  );
+  program2.command("bug").description("Launch Claude in /bug mode, chain into next on /next signal").option("--once", "Exit when the initial task completes").action(
+    (opts) => launchMode("bug", { once: opts.once })
+  );
   program2.command("review-comments").argument("[number]", "PR number to check out first").description("Launch Claude in /review-comments mode (single session)").action((number) => reviewComments(number));
-  program2.command("refine").argument("[id]", "Backlog item ID").description("Launch Claude in /refine mode to refine a backlog item").action((id) => refine(id));
+  program2.command("refine").argument("[id]", "Backlog item ID").description("Launch Claude in /refine mode to refine a backlog item").option("--once", "Exit when the initial task completes").action(
+    (id, opts) => refine(id, { once: opts.once })
+  );
 }
 
 // src/commands/registerList.ts
@@ -10244,12 +10308,12 @@ import { execSync as execSync32 } from "child_process";
 
 // src/commands/prs/resolveCommentWithReply.ts
 import { execSync as execSync31 } from "child_process";
-import { unlinkSync as unlinkSync8, writeFileSync as writeFileSync21 } from "fs";
+import { unlinkSync as unlinkSync9, writeFileSync as writeFileSync21 } from "fs";
 import { tmpdir as tmpdir5 } from "os";
 import { join as join32 } from "path";
 
 // src/commands/prs/loadCommentsCache.ts
-import { existsSync as existsSync33, readFileSync as readFileSync28, unlinkSync as unlinkSync7 } from "fs";
+import { existsSync as existsSync33, readFileSync as readFileSync28, unlinkSync as unlinkSync8 } from "fs";
 import { join as join31 } from "path";
 import { parse as parse2 } from "yaml";
 function getCachePath(prNumber) {
@@ -10266,7 +10330,7 @@ function loadCommentsCache(prNumber) {
 function deleteCommentsCache(prNumber) {
   const cachePath = getCachePath(prNumber);
   if (existsSync33(cachePath)) {
-    unlinkSync7(cachePath);
+    unlinkSync8(cachePath);
     console.log("No more unresolved line comments. Cache dropped.");
   }
 }
@@ -10288,7 +10352,7 @@ function resolveThread(threadId) {
       { stdio: ["inherit", "pipe", "inherit"] }
     );
   } finally {
-    unlinkSync8(queryFile);
+    unlinkSync9(queryFile);
   }
 }
 function requireCache(prNumber) {
@@ -10368,7 +10432,7 @@ import { stringify } from "yaml";
 
 // src/commands/prs/fetchThreadIds.ts
 import { execSync as execSync33 } from "child_process";
-import { unlinkSync as unlinkSync9, writeFileSync as writeFileSync22 } from "fs";
+import { unlinkSync as unlinkSync10, writeFileSync as writeFileSync22 } from "fs";
 import { tmpdir as tmpdir6 } from "os";
 import { join as join33 } from "path";
 var THREAD_QUERY = `query($owner: String!, $repo: String!, $prNumber: Int!) { repository(owner: $owner, name: $repo) { pullRequest(number: $prNumber) { reviewThreads(first: 100) { nodes { id isResolved comments(first: 100) { nodes { databaseId } } } } } } }`;
@@ -10393,7 +10457,7 @@ function fetchThreadIds(org, repo, prNumber) {
     }
     return { threadMap, resolvedThreadIds };
   } finally {
-    unlinkSync9(queryFile);
+    unlinkSync10(queryFile);
   }
 }
 
@@ -13301,10 +13365,10 @@ async function handlePostSynthesis(synthesisPath, options2) {
 }
 
 // src/commands/review/prepareReviewDir.ts
-import { existsSync as existsSync36, mkdirSync as mkdirSync11, unlinkSync as unlinkSync10, writeFileSync as writeFileSync25 } from "fs";
+import { existsSync as existsSync36, mkdirSync as mkdirSync11, unlinkSync as unlinkSync11, writeFileSync as writeFileSync25 } from "fs";
 function clearReviewFiles(paths) {
   for (const path54 of [paths.claudePath, paths.codexPath, paths.synthesisPath]) {
-    if (existsSync36(path54)) unlinkSync10(path54);
+    if (existsSync36(path54)) unlinkSync11(path54);
   }
 }
 function prepareReviewDir(paths, requestBody, force) {
@@ -13372,11 +13436,11 @@ async function runBacklogSession(synthesisPath) {
 }
 
 // src/commands/review/cachedReviewerResult.ts
-import { statSync as statSync2 } from "fs";
+import { statSync as statSync3 } from "fs";
 function cachedReviewerResult(name, outputPath) {
   let size;
   try {
-    size = statSync2(outputPath).size;
+    size = statSync3(outputPath).size;
   } catch {
     return null;
   }
@@ -13589,7 +13653,7 @@ function printReviewerFailures(results) {
 }
 
 // src/commands/review/runAndSynthesise.ts
-import { existsSync as existsSync38, unlinkSync as unlinkSync12 } from "fs";
+import { existsSync as existsSync38, unlinkSync as unlinkSync13 } from "fs";
 
 // src/commands/review/buildReviewerStdin.ts
 var REVIEW_PROMPT = `You are acting as a reviewer for a proposed code change made by another engineer. The full review request \u2014 branch, base, changed files, and unified diff \u2014 is in request.md in the current working directory.
@@ -14007,7 +14071,7 @@ function resolveClaude(args) {
 }
 
 // src/commands/review/runCodexReviewer.ts
-import { existsSync as existsSync37, unlinkSync as unlinkSync11 } from "fs";
+import { existsSync as existsSync37, unlinkSync as unlinkSync12 } from "fs";
 
 // src/commands/review/parseCodexEvent.ts
 function isItemStarted(value) {
@@ -14062,7 +14126,7 @@ async function runCodexReviewer(spec) {
     }
   });
   if (result.exitCode !== 0 && existsSync37(spec.outputPath)) {
-    unlinkSync11(spec.outputPath);
+    unlinkSync12(spec.outputPath);
   }
   return finaliseReviewerRun({ ...spec, command }, spinner, result);
 }
@@ -14210,7 +14274,7 @@ async function runAndSynthesise(args) {
     return { ok: false, failures };
   }
   if (anyFresh && existsSync38(paths.synthesisPath)) {
-    unlinkSync12(paths.synthesisPath);
+    unlinkSync13(paths.synthesisPath);
   }
   const synthesisResult = await synthesise(paths, { multi });
   if (synthesisResult.exitCode !== 0) failures.push(synthesisResult);
@@ -14709,6 +14773,10 @@ function registerSignal(program2) {
     writeSignal("next", id ? { id } : void 0);
     console.log("Signal written.");
   });
+  signalCommand.command("done").description("Write a done signal to end a --once launch session").action(() => {
+    writeSignal("done");
+    console.log("Signal written.");
+  });
 }
 
 // src/commands/sql/sqlAuth.ts
@@ -14981,7 +15049,7 @@ function registerSql(program2) {
 }
 
 // src/commands/transcript/shared.ts
-import { existsSync as existsSync39, readdirSync as readdirSync6, statSync as statSync3 } from "fs";
+import { existsSync as existsSync39, readdirSync as readdirSync6, statSync as statSync4 } from "fs";
 import { basename as basename6, join as join37, relative as relative2 } from "path";
 import * as readline2 from "readline";
 var DATE_PREFIX_REGEX = /^\d{4}-\d{2}-\d{2}/;
@@ -15001,7 +15069,7 @@ function collectFiles(dir, extension) {
   const results = [];
   for (const entry of readdirSync6(dir)) {
     const fullPath = join37(dir, entry);
-    if (statSync3(fullPath).isDirectory()) {
+    if (statSync4(fullPath).isDirectory()) {
       results.push(...collectFiles(fullPath, extension));
     } else if (entry.endsWith(extension)) {
       results.push(fullPath);
@@ -15875,7 +15943,7 @@ function status() {
 }
 
 // src/commands/voice/stop.ts
-import { existsSync as existsSync47, readFileSync as readFileSync37, unlinkSync as unlinkSync13 } from "fs";
+import { existsSync as existsSync47, readFileSync as readFileSync37, unlinkSync as unlinkSync14 } from "fs";
 function stop2() {
   if (!existsSync47(voicePaths.pid)) {
     console.log("Voice daemon is not running (no PID file)");
@@ -15889,12 +15957,12 @@ function stop2() {
     console.log(`Voice daemon (PID ${pid}) is not running`);
   }
   try {
-    unlinkSync13(voicePaths.pid);
+    unlinkSync14(voicePaths.pid);
   } catch {
   }
   try {
     const lockFile = getLockFile();
-    if (existsSync47(lockFile)) unlinkSync13(lockFile);
+    if (existsSync47(lockFile)) unlinkSync14(lockFile);
   } catch {
   }
   console.log("Voice daemon stopped");
@@ -16116,7 +16184,7 @@ async function auth() {
 
 // src/commands/roam/postRoamActivity.ts
 import { execFileSync as execFileSync7 } from "child_process";
-import { readdirSync as readdirSync7, readFileSync as readFileSync38, statSync as statSync4 } from "fs";
+import { readdirSync as readdirSync7, readFileSync as readFileSync38, statSync as statSync5 } from "fs";
 import { join as join48 } from "path";
 function findPortFile(roamDir) {
   let entries;
@@ -16128,7 +16196,7 @@ function findPortFile(roamDir) {
   const candidates = entries.filter((name) => /^roam-local-api(-[^.]+)?\.port$/.test(name)).map((name) => {
     const path54 = join48(roamDir, name);
     try {
-      return { path: path54, mtimeMs: statSync4(path54).mtimeMs };
+      return { path: path54, mtimeMs: statSync5(path54).mtimeMs };
     } catch {
       return void 0;
     }
@@ -16477,7 +16545,7 @@ function link2() {
 }
 
 // src/commands/run/remove.ts
-import { existsSync as existsSync49, unlinkSync as unlinkSync14 } from "fs";
+import { existsSync as existsSync49, unlinkSync as unlinkSync15 } from "fs";
 import { join as join51 } from "path";
 function findRemoveIndex() {
   const idx = process.argv.indexOf("remove");
@@ -16495,7 +16563,7 @@ function parseRemoveName() {
 function deleteCommandFile(name) {
   const filePath = join51(".claude", "commands", `${name}.md`);
   if (existsSync49(filePath)) {
-    unlinkSync14(filePath);
+    unlinkSync15(filePath);
     console.log(`Deleted command file: ${filePath}`);
   }
 }
@@ -16530,7 +16598,7 @@ function registerRun(program2) {
 
 // src/commands/screenshot/index.ts
 import { execSync as execSync47 } from "child_process";
-import { existsSync as existsSync50, mkdirSync as mkdirSync18, unlinkSync as unlinkSync15, writeFileSync as writeFileSync31 } from "fs";
+import { existsSync as existsSync50, mkdirSync as mkdirSync18, unlinkSync as unlinkSync16, writeFileSync as writeFileSync31 } from "fs";
 import { tmpdir as tmpdir7 } from "os";
 import { join as join52, resolve as resolve13 } from "path";
 import chalk156 from "chalk";
@@ -16677,7 +16745,7 @@ function runPowerShellScript(processName, outputPath) {
       { stdio: ["ignore", "pipe", "pipe"], encoding: "utf-8" }
     );
   } finally {
-    unlinkSync15(scriptPath);
+    unlinkSync16(scriptPath);
   }
 }
 function screenshot(processName) {
@@ -16695,51 +16763,108 @@ function screenshot(processName) {
   }
 }
 
-// src/commands/sessions/daemon/daemonStatus.ts
-import { existsSync as existsSync51, readFileSync as readFileSync39 } from "fs";
-import { createInterface as createInterface4 } from "readline";
-var STATUS_TIMEOUT_MS = 5e3;
-async function daemonStatus() {
-  let socket;
+// src/commands/sessions/daemon/listDaemonPids.ts
+import { execFileSync as execFileSync9 } from "child_process";
+function listDaemonPids() {
+  if (process.platform === "win32") return [];
   try {
-    socket = await connectToDaemon();
+    const out = execFileSync9("ps", ["-eo", "pid=,args="], {
+      encoding: "utf-8"
+    });
+    return out.split("\n").filter((line) => line.includes("assist") && / daemon run\b/.test(line)).map((line) => Number.parseInt(line.trim(), 10)).filter((pid) => Number.isInteger(pid));
   } catch {
-    console.log("Sessions daemon is not running");
-    return;
-  }
-  const sessions = await readSessionList(socket);
-  socket.destroy();
-  console.log(`Sessions daemon is running${describePid()}`);
-  if (sessions.length === 0) {
-    console.log("No sessions");
-    return;
+    return [];
   }
-  for (const session of sessions) {
-    const restored = session.restored === false ? " (not restored)" : "";
-    console.log(`  [${session.status}] ${session.name}${restored}`);
-  }
-}
-function describePid() {
-  if (!existsSync51(daemonPaths.pid)) return "";
-  return ` (PID ${readFileSync39(daemonPaths.pid, "utf-8").trim()})`;
 }
-function readSessionList(socket) {
+
+// src/commands/sessions/daemon/queryDaemon.ts
+import { createInterface as createInterface4 } from "readline";
+var STATUS_TIMEOUT_MS = 5e3;
+function queryDaemon(socket) {
+  socket.write(`${JSON.stringify({ type: "ping" })}
+`);
   return new Promise((resolve16) => {
-    const timer = setTimeout(() => resolve16([]), STATUS_TIMEOUT_MS);
+    const result = { sessions: [] };
+    const pending = /* @__PURE__ */ new Set(["sessions", "pong"]);
+    const timer = setTimeout(() => resolve16(result), STATUS_TIMEOUT_MS);
     const lines = createInterface4({ input: socket });
     lines.on("error", () => {
     });
     lines.on("line", (line) => {
-      try {
-        const data = JSON.parse(line);
-        if (data.type !== "sessions") return;
+      applyLine(result, pending, line);
+      if (pending.size === 0) {
         clearTimeout(timer);
-        resolve16(data.sessions ?? []);
-      } catch {
+        resolve16(result);
       }
     });
   });
 }
+function applyLine(result, pending, line) {
+  try {
+    const data = JSON.parse(line);
+    if (data.type === "sessions") {
+      result.sessions = data.sessions ?? [];
+      pending.delete("sessions");
+    } else if (data.type === "pong") {
+      result.pid = data.pid;
+      pending.delete("pong");
+    }
+  } catch {
+  }
+}
+
+// src/commands/sessions/daemon/reportStolenSocket.ts
+import { readFileSync as readFileSync39 } from "fs";
+function reportStolenSocket(socketPid) {
+  if (!socketPid) return;
+  const filePid = readPidFile();
+  if (filePid === void 0 || filePid === socketPid) return;
+  console.error(
+    `Warning: daemon.pid records PID ${filePid} but the socket is owned by PID ${socketPid} (stolen socket)`
+  );
+}
+function readPidFile() {
+  try {
+    const pid = Number.parseInt(
+      readFileSync39(daemonPaths.pid, "utf-8").trim(),
+      10
+    );
+    return Number.isInteger(pid) ? pid : void 0;
+  } catch {
+    return void 0;
+  }
+}
+
+// src/commands/sessions/daemon/daemonStatus.ts
+async function daemonStatus() {
+  let socket;
+  try {
+    socket = await connectToDaemon();
+  } catch {
+    console.log("Sessions daemon is not running");
+    reportStrays(listDaemonPids());
+    return;
+  }
+  const { pid, sessions } = await queryDaemon(socket);
+  socket.destroy();
+  console.log(`Sessions daemon is running${pid ? ` (PID ${pid})` : ""}`);
+  reportStolenSocket(pid);
+  reportStrays(listDaemonPids().filter((p) => p !== pid));
+  if (sessions.length === 0) {
+    console.log("No sessions");
+    return;
+  }
+  for (const session of sessions) {
+    const restored = session.restored === false ? " (not restored)" : "";
+    console.log(`  [${session.status}] ${session.name}${restored}`);
+  }
+}
+function reportStrays(pids) {
+  if (pids.length === 0) return;
+  console.error(
+    `Warning: stray daemon process(es) detected: ${pids.join(", ")}`
+  );
+}
 
 // src/commands/sessions/daemon/stopDaemon.ts
 var STOP_TIMEOUT_MS = 5e3;
@@ -16781,15 +16906,14 @@ function closedBeforeTimeout(socket) {
 // src/commands/sessions/daemon/restartDaemon.ts
 async function restartDaemon() {
   await stopDaemon();
-  await ensureDaemonRunning();
+  await ensureDaemonRunning("daemon restart");
   console.log(
     "Sessions daemon restarted; previously running claude sessions will resume"
   );
 }
 
 // src/commands/sessions/daemon/runDaemon.ts
-import { existsSync as existsSync53, mkdirSync as mkdirSync19, unlinkSync as unlinkSync16, writeFileSync as writeFileSync32 } from "fs";
-import * as net2 from "net";
+import { mkdirSync as mkdirSync19 } from "fs";
 
 // src/commands/sessions/daemon/createAutoExit.ts
 var DEFAULT_GRACE_MS = 6e4;
@@ -16805,137 +16929,9 @@ function createAutoExit(exit, graceMs = DEFAULT_GRACE_MS) {
   };
 }
 
-// src/commands/sessions/daemon/handleConnection.ts
-import { createInterface as createInterface5 } from "readline";
-
-// src/commands/sessions/daemon/broadcast.ts
-function sendTo(client, msg) {
-  client.send(JSON.stringify(msg));
-}
-function broadcast(clients, msg) {
-  const json = JSON.stringify(msg);
-  for (const client of clients) {
-    client.send(json);
-  }
-}
-
-// src/commands/sessions/daemon/handleRunConfigs.ts
-function handleRunConfigs(client, cwd) {
-  try {
-    const { config, configDir } = loadConfigFrom(cwd);
-    const configs = resolveRunConfigs(config.run, configDir);
-    sendTo(client, {
-      type: "run-configs",
-      configs: configs.map(({ name, params }) => ({ name, params }))
-    });
-  } catch {
-    sendTo(client, { type: "run-configs", configs: [] });
-  }
-}
-
-// src/commands/sessions/daemon/dispatchMessage.ts
-function sendCreated(client, id) {
-  sendTo(client, { type: "created", sessionId: id });
-}
-function handleCreate(client, manager, data) {
-  sendCreated(
-    client,
-    manager.spawn(
-      data.prompt,
-      data.cwd
-    )
-  );
-}
-function handleCreateRun(client, manager, data) {
-  sendCreated(
-    client,
-    manager.spawnRun(
-      data.runName,
-      data.runArgs ?? [],
-      data.cwd
-    )
-  );
-}
-function handleCreateAssist(client, manager, data) {
-  sendCreated(
-    client,
-    manager.spawnAssist(
-      data.assistArgs ?? [],
-      data.cwd
-    )
-  );
-}
-function handleResume(client, manager, data) {
-  sendCreated(
-    client,
-    manager.resume(
-      data.sessionId,
-      data.cwd,
-      data.name
-    )
-  );
-}
-function runConfigs(client, _manager, data) {
-  handleRunConfigs(client, data.cwd);
-}
-function handleHistory(client, manager) {
-  manager.getHistory().then((history) => {
-    sendTo(client, { type: "history", sessions: history });
-  });
-}
-function handleShutdown(client, manager) {
-  manager.shutdown();
-  sendTo(client, { type: "shutting-down" });
-  setImmediate(() => process.exit(0));
-}
-var handlers = {
-  create: handleCreate,
-  "create-run": handleCreateRun,
-  "create-assist": handleCreateAssist,
-  resume: handleResume,
-  "run-configs": runConfigs,
-  history: handleHistory,
-  shutdown: handleShutdown,
-  input: (_client, m, d) => m.writeToSession(d.sessionId, d.data),
-  resize: (_client, m, d) => m.resizeSession(d.sessionId, d.cols, d.rows),
-  retry: (_client, m, d) => m.retrySession(d.sessionId),
-  dismiss: (_client, m, d) => m.dismissSession(d.sessionId)
-};
-function dispatchMessage(client, manager, data) {
-  handlers[data.type]?.(client, manager, data);
-}
-
-// src/commands/sessions/daemon/handleConnection.ts
-function handleConnection(socket, manager) {
-  const client = {
-    send: (data) => {
-      if (socket.writable) socket.write(`${data}
-`);
-    }
-  };
-  manager.addClient(client);
-  const lines = createInterface5({ input: socket });
-  lines.on("error", () => {
-  });
-  lines.on("line", (line) => {
-    let data;
-    try {
-      data = JSON.parse(line);
-    } catch {
-      return;
-    }
-    try {
-      dispatchMessage(client, manager, data);
-    } catch (e) {
-      sendTo(client, {
-        type: "error",
-        message: `${data.type} failed: ${e instanceof Error ? e.message : String(e)}`
-      });
-    }
-  });
-  socket.on("error", () => {
-  });
-  socket.on("close", () => manager.removeClient(client));
+// src/commands/sessions/daemon/daemonLog.ts
+function daemonLog(message) {
+  console.log(`${(/* @__PURE__ */ new Date()).toISOString()} [${process.pid}] ${message}`);
 }
 
 // src/commands/sessions/shared/discoverSessions.ts
@@ -17053,6 +17049,17 @@ async function discoverSessions() {
   return sessions;
 }
 
+// src/commands/sessions/daemon/broadcast.ts
+function sendTo(client, msg) {
+  client.send(JSON.stringify(msg));
+}
+function broadcast(clients, msg) {
+  const json = JSON.stringify(msg);
+  for (const client of clients) {
+    client.send(json);
+  }
+}
+
 // src/commands/sessions/daemon/repoPrefix.ts
 import * as path47 from "path";
 function repoPrefix(cwd) {
@@ -17064,7 +17071,7 @@ function repoPrefix(cwd) {
 import * as pty from "node-pty";
 
 // src/commands/sessions/daemon/ensureSpawnHelperExecutable.ts
-import { chmodSync, existsSync as existsSync52, statSync as statSync5 } from "fs";
+import { chmodSync, existsSync as existsSync51, statSync as statSync6 } from "fs";
 import { createRequire as createRequire3 } from "module";
 import path48 from "path";
 var require4 = createRequire3(import.meta.url);
@@ -17079,8 +17086,8 @@ function ensureSpawnHelperExecutable() {
     `${process.platform}-${process.arch}`,
     "spawn-helper"
   );
-  if (!existsSync52(helper)) return;
-  const mode = statSync5(helper).mode;
+  if (!existsSync51(helper)) return;
+  const mode = statSync6(helper).mode;
   if ((mode & 73) === 0) chmodSync(helper, mode | 493);
 }
 
@@ -17474,9 +17481,10 @@ var SessionManager = class {
     shutdownSessions(this.sessions);
   }
   restore() {
-    for (const persisted of loadPersistedSessions()) {
+    return loadPersistedSessions().map((persisted) => {
       this.add(restoreSession(String(this.nextId++), persisted));
-    }
+      return persisted.name;
+    });
   }
   add(session) {
     this.wire(session);
@@ -17538,31 +17546,231 @@ var SessionManager = class {
   };
 };
 
+// src/commands/sessions/daemon/startDaemonServer.ts
+import { unlinkSync as unlinkSync18 } from "fs";
+import * as net2 from "net";
+
+// src/commands/sessions/daemon/handleConnection.ts
+import { createInterface as createInterface5 } from "readline";
+
+// src/commands/sessions/daemon/handleRunConfigs.ts
+function handleRunConfigs(client, cwd) {
+  try {
+    const { config, configDir } = loadConfigFrom(cwd);
+    const configs = resolveRunConfigs(config.run, configDir);
+    sendTo(client, {
+      type: "run-configs",
+      configs: configs.map(({ name, params }) => ({ name, params }))
+    });
+  } catch {
+    sendTo(client, { type: "run-configs", configs: [] });
+  }
+}
+
+// src/commands/sessions/daemon/dispatchMessage.ts
+function sendCreated(client, id) {
+  sendTo(client, { type: "created", sessionId: id });
+}
+function handleCreate(client, manager, data) {
+  sendCreated(
+    client,
+    manager.spawn(
+      data.prompt,
+      data.cwd
+    )
+  );
+}
+function handleCreateRun(client, manager, data) {
+  sendCreated(
+    client,
+    manager.spawnRun(
+      data.runName,
+      data.runArgs ?? [],
+      data.cwd
+    )
+  );
+}
+function handleCreateAssist(client, manager, data) {
+  sendCreated(
+    client,
+    manager.spawnAssist(
+      data.assistArgs ?? [],
+      data.cwd
+    )
+  );
+}
+function handleResume(client, manager, data) {
+  sendCreated(
+    client,
+    manager.resume(
+      data.sessionId,
+      data.cwd,
+      data.name
+    )
+  );
+}
+function runConfigs(client, _manager, data) {
+  handleRunConfigs(client, data.cwd);
+}
+function handleHistory(client, manager) {
+  manager.getHistory().then((history) => {
+    sendTo(client, { type: "history", sessions: history });
+  });
+}
+function handleShutdown(client, manager) {
+  manager.shutdown();
+  sendTo(client, { type: "shutting-down" });
+  setImmediate(() => process.exit(0));
+}
+var handlers = {
+  ping: (client) => sendTo(client, { type: "pong", pid: process.pid }),
+  create: handleCreate,
+  "create-run": handleCreateRun,
+  "create-assist": handleCreateAssist,
+  resume: handleResume,
+  "run-configs": runConfigs,
+  history: handleHistory,
+  shutdown: handleShutdown,
+  input: (_client, m, d) => m.writeToSession(d.sessionId, d.data),
+  resize: (_client, m, d) => m.resizeSession(d.sessionId, d.cols, d.rows),
+  retry: (_client, m, d) => m.retrySession(d.sessionId),
+  dismiss: (_client, m, d) => m.dismissSession(d.sessionId)
+};
+function dispatchMessage(client, manager, data) {
+  handlers[data.type]?.(client, manager, data);
+}
+
+// src/commands/sessions/daemon/handleConnection.ts
+function handleConnection(socket, manager) {
+  const client = {
+    send: (data) => {
+      if (socket.writable) socket.write(`${data}
+`);
+    }
+  };
+  manager.addClient(client);
+  const lines = createInterface5({ input: socket });
+  lines.on("error", () => {
+  });
+  lines.on("line", (line) => {
+    let data;
+    try {
+      data = JSON.parse(line);
+    } catch {
+      return;
+    }
+    try {
+      dispatchMessage(client, manager, data);
+    } catch (e) {
+      sendTo(client, {
+        type: "error",
+        message: `${data.type} failed: ${e instanceof Error ? e.message : String(e)}`
+      });
+    }
+  });
+  socket.on("error", () => {
+  });
+  socket.on("close", () => manager.removeClient(client));
+}
+
+// src/commands/sessions/daemon/onListening.ts
+import { unlinkSync as unlinkSync17, writeFileSync as writeFileSync32 } from "fs";
+
+// src/commands/sessions/daemon/startPidFileWatchdog.ts
+import { readFileSync as readFileSync40 } from "fs";
+var WATCHDOG_INTERVAL_MS = 5e3;
+function startPidFileWatchdog(onLost, intervalMs = WATCHDOG_INTERVAL_MS) {
+  const timer = setInterval(() => {
+    if (!ownsPidFile()) onLost();
+  }, intervalMs);
+  timer.unref();
+  return timer;
+}
+function ownsPidFile() {
+  try {
+    return readFileSync40(daemonPaths.pid, "utf-8").trim() === String(process.pid);
+  } catch {
+    return false;
+  }
+}
+
+// src/commands/sessions/daemon/onListening.ts
+function onListening(manager, checkAutoExit) {
+  writeFileSync32(daemonPaths.pid, String(process.pid));
+  startPidFileWatchdog(() => {
+    daemonLog("lost daemon.pid ownership; shutting down sessions and exiting");
+    manager.shutdown();
+    process.exit(0);
+  });
+  process.on("exit", cleanupOwnedFiles);
+  const restored = manager.restore();
+  daemonLog(
+    restored.length > 0 ? `restored ${restored.length} session(s): ${restored.join(", ")}` : "no persisted sessions to restore"
+  );
+  daemonLog(`listening on ${daemonPaths.socket}`);
+  checkAutoExit(manager.isIdle());
+}
+function cleanupOwnedFiles() {
+  if (!ownsPidFile()) return;
+  try {
+    unlinkSync17(daemonPaths.pid);
+  } catch {
+  }
+  if (process.platform !== "win32") {
+    try {
+      unlinkSync17(daemonPaths.socket);
+    } catch {
+    }
+  }
+}
+
+// src/commands/sessions/daemon/startDaemonServer.ts
+function startDaemonServer(manager, checkAutoExit) {
+  const server = net2.createServer(
+    (socket) => handleConnection(socket, manager)
+  );
+  let retried = false;
+  server.on("error", (e) => {
+    if (e.code !== "EADDRINUSE" || retried) {
+      daemonLog(`server error: ${e.message}; exiting`);
+      process.exit(1);
+    }
+    retried = true;
+    void recoverFromAddrInUse(server, manager, checkAutoExit);
+  });
+  server.listen(daemonPaths.socket, () => onListening(manager, checkAutoExit));
+}
+async function recoverFromAddrInUse(server, manager, checkAutoExit) {
+  if (await isDaemonRunning()) {
+    daemonLog("another daemon owns the socket; exiting");
+    process.exit(1);
+  }
+  daemonLog("removing stale socket left by a crashed daemon");
+  if (process.platform !== "win32") {
+    try {
+      unlinkSync18(daemonPaths.socket);
+    } catch {
+    }
+  }
+  server.listen(daemonPaths.socket, () => onListening(manager, checkAutoExit));
+}
+
 // src/commands/sessions/daemon/runDaemon.ts
 async function runDaemon() {
   mkdirSync19(daemonPaths.dir, { recursive: true });
+  daemonLog(
+    `starting (reason: ${process.env.ASSIST_DAEMON_SPAWN_REASON ?? "manual"})`
+  );
   if (await isDaemonRunning()) {
-    console.error("Sessions daemon is already running");
+    daemonLog("already running; exiting");
     process.exitCode = 1;
     return;
   }
-  if (process.platform !== "win32" && existsSync53(daemonPaths.socket)) {
-    unlinkSync16(daemonPaths.socket);
-  }
   const checkAutoExit = createAutoExit(() => {
-    console.log("No sessions and no connected server; exiting");
+    daemonLog("no sessions and no connected server; exiting");
     process.exit(0);
   });
-  const manager = new SessionManager(checkAutoExit);
-  manager.restore();
-  const server = net2.createServer(
-    (socket) => handleConnection(socket, manager)
-  );
-  server.listen(daemonPaths.socket, () => {
-    writeFileSync32(daemonPaths.pid, String(process.pid));
-    console.log(`Sessions daemon listening on ${daemonPaths.socket}`);
-    checkAutoExit(manager.isIdle());
-  });
+  startDaemonServer(new SessionManager(checkAutoExit), checkAutoExit);
 }
 
 // src/commands/sessions/daemon/registerDaemon.ts
@@ -17571,7 +17779,9 @@ function registerDaemon(program2) {
   cmd.command("run").description(
     "Run the sessions daemon in the foreground (auto-spawned by assist sessions)"
   ).action(runDaemon);
-  cmd.command("status").description("Show sessions daemon status and live sessions").action(daemonStatus);
+  cmd.command("status").description(
+    "Show sessions daemon status, live sessions, and any stray daemon processes"
+  ).action(daemonStatus);
   cmd.command("stop").description(
     "Stop the sessions daemon; running claude sessions resume on next start"
   ).action(stopDaemon);
@@ -17598,7 +17808,7 @@ function summaryPathFor(jsonlPath2) {
 }
 
 // src/commands/sessions/summarise/summariseSession.ts
-import { execFileSync as execFileSync9 } from "child_process";
+import { execFileSync as execFileSync10 } from "child_process";
 
 // src/commands/sessions/summarise/iterateUserMessages.ts
 import * as fs28 from "fs";
@@ -17675,7 +17885,7 @@ function summariseSession(jsonlPath2) {
   }
   const prompt = buildPrompt2(firstMessage, backlogIds);
   try {
-    const output = execFileSync9("claude", ["-p", "--model", "haiku", prompt], {
+    const output = execFileSync10("claude", ["-p", "--model", "haiku", prompt], {
       encoding: "utf8",
       timeout: 3e4,
       stdio: ["ignore", "pipe", "ignore"]