@staff0rd/assist 0.571.1 → 0.572.1

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.571.1",
+  version: "0.572.1",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -16722,6 +16722,10 @@ var BUILTIN_DENIES = [
     pattern: "gh pr edit",
     message: "Do not run 'gh pr edit' directly. Use 'assist prs edit [--title <title>] [--what <what>] [--why <why>] [--how <how>]' instead \u2014 it assembles and validates the body before delegating to gh, and in an assist web session blocks on the preview pane until the user approves or rejects. Compose the sections and run it; see 'assist prs edit --help' for how to pitch each section."
   },
+  {
+    pattern: "gh issue create",
+    message: "Do not run 'gh issue create' directly. Use 'assist github issue create --title <title> --body <body> [-R <owner>/<repo>]' instead \u2014 it validates the title and body before delegating to gh, and gates the issue on the user's approval itself. Run 'assist github issue create --help' and follow its guidance to compose the body; it is authoritative on how approval is handled in this environment."
+  },
   {
     pattern: "git commit",
     message: `Do not run 'git commit' directly. Use 'assist commit "<message>"' instead.`
@@ -20625,6 +20629,72 @@ function commits(org, options2) {
   }
 }
 
+// src/commands/github/issue/createIssue.ts
+import { execFileSync as execFileSync6 } from "child_process";
+
+// src/shared/validateProposedContent.ts
+function validateProposedContent(labels, title, body) {
+  const { subject, context } = labels;
+  if (title.toLowerCase().includes("claude")) {
+    console.error(`Error: ${subject} title must not reference Claude`);
+    process.exit(1);
+  }
+  if (body.toLowerCase().includes("claude")) {
+    console.error(`Error: ${subject} body must not reference Claude`);
+    process.exit(1);
+  }
+  const titleBacklogIds = findBacklogRefs(title);
+  if (titleBacklogIds.length > 0) {
+    console.error(
+      backlogRefError(`${subject} title`, context, titleBacklogIds)
+    );
+    process.exit(1);
+  }
+  const bodyBacklogIds = findBacklogRefs(body);
+  if (bodyBacklogIds.length > 0) {
+    console.error(backlogRefError(`${subject} body`, context, bodyBacklogIds));
+    process.exit(1);
+  }
+}
+
+// src/commands/github/issue/reviewProposedIssue.ts
+import { randomUUID as randomUUID7 } from "crypto";
+async function reviewProposedIssue(title, body) {
+  const sessionId = process.env.ASSIST_SESSION_ID;
+  if (process.env.ASSIST_SESSION !== "1" || !sessionId) return;
+  await awaitPreviewApproval("GitHub issue preview", {
+    sessionId,
+    requestId: randomUUID7(),
+    title,
+    body,
+    prNumber: null,
+    kind: "github-issue"
+  });
+}
+
+// src/commands/github/issue/createIssue.ts
+var USAGE = "Usage: assist github issue create --title <title> --body <body> [-R <owner>/<repo>]";
+async function createIssue(options2) {
+  if (!options2.title || !options2.body) {
+    console.error(USAGE);
+    process.exit(1);
+  }
+  const { title, body } = options2;
+  validateProposedContent(
+    { subject: "Issue", context: "GitHub issues" },
+    title,
+    body
+  );
+  await reviewProposedIssue(title, body);
+  const args = ["issue", "create", "--title", title, "--body", body];
+  if (options2.repo) args.push("--repo", options2.repo);
+  try {
+    execFileSync6("gh", args, { stdio: "inherit" });
+  } catch {
+    process.exit(1);
+  }
+}
+
 // src/commands/github/parseSinceDate.ts
 import { InvalidArgumentError } from "commander";
 function parseSinceDate(value) {
@@ -20659,6 +20729,14 @@ function registerGithub(program2) {
     "only report the top <n> repos by commit count",
     parseTopCount
   ).option("--json", "Output as JSON").action(commits);
+  const issueCommand = githubCommand.command("issue").description("GitHub issue utilities");
+  issueCommand.command("create").description("Create a GitHub issue").option("--title <title>", "Issue title").option("--body <body>", "Issue body").option(
+    "-R, --repo <owner/repo>",
+    "Target repository (defaults to the current repo)"
+  ).addHelpText(
+    "after",
+    "\nThere is no What/Why/How template: an issue reports a problem, and the target repo's own issue template is unknowable from here. Write the body as the repo's maintainers would expect.\nIn an assist web session the title and body are previewed for approve/reject first (with inline comments); nothing is created until it is approved."
+  ).action(createIssue);
 }
 
 // src/commands/handover/countPendingHandovers.ts
@@ -21068,10 +21146,10 @@ function registerRefineLaunch(program2, resumeFlag) {
 }
 
 // src/commands/reviewPrComments.ts
-import { randomUUID as randomUUID7 } from "crypto";
+import { randomUUID as randomUUID8 } from "crypto";
 
 // src/commands/review/checkoutPr.ts
-import { execFileSync as execFileSync7 } from "child_process";
+import { execFileSync as execFileSync8 } from "child_process";
 import chalk164 from "chalk";
 
 // src/commands/sessions/daemon/daemonLog.ts
@@ -21631,10 +21709,10 @@ async function moveToPrCheckoutTree() {
 }
 
 // src/commands/review/prHeadBranch.ts
-import { execFileSync as execFileSync6 } from "child_process";
+import { execFileSync as execFileSync7 } from "child_process";
 function prHeadBranch(number) {
   try {
-    const out = execFileSync6(
+    const out = execFileSync7(
       "gh",
       ["pr", "view", number, "--json", "headRefName", "-q", ".headRefName"],
       { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }
@@ -21682,7 +21760,7 @@ async function checkoutPr(number) {
   if (headRef && moveToExistingCheckout(number, headRef)) return;
   await moveToPrCheckoutTree();
   try {
-    execFileSync7("gh", ["pr", "checkout", number], { stdio: "inherit" });
+    execFileSync8("gh", ["pr", "checkout", number], { stdio: "inherit" });
   } catch {
     console.error(chalk164.red(`gh pr checkout ${number} failed; aborting.`));
     process.exit(1);
@@ -21704,7 +21782,7 @@ async function reviewPrComments(number, options2 = {}) {
   const resumeSessionId = options2.resumeSessionId;
   validateAnnounce(number, announce);
   if (number && !resumeSessionId) await checkoutPr(number);
-  const claudeSessionId = resumeSessionId ?? randomUUID7();
+  const claudeSessionId = resumeSessionId ?? randomUUID8();
   emitActivity({
     kind: "command",
     name: "review-pr-comments",
@@ -21722,14 +21800,14 @@ async function reviewPrComments(number, options2 = {}) {
 }
 
 // src/commands/fixConflict.ts
-import { randomUUID as randomUUID8 } from "crypto";
+import { randomUUID as randomUUID9 } from "crypto";
 function buildPrompt3(rebase) {
   return rebase ? "/fix-conflict --rebase" : "/fix-conflict";
 }
 async function fixConflict(number, options2 = {}) {
   const { resumeSessionId } = options2;
   if (number && !resumeSessionId) await checkoutPr(number);
-  const claudeSessionId = resumeSessionId ?? randomUUID8();
+  const claudeSessionId = resumeSessionId ?? randomUUID9();
   emitActivity({
     kind: "command",
     name: "fix-conflict",
@@ -22751,13 +22829,13 @@ function postReviewComment(vars) {
 }
 
 // src/commands/prs/reviewProposedPrComment.ts
-import { randomUUID as randomUUID9 } from "crypto";
+import { randomUUID as randomUUID10 } from "crypto";
 async function reviewProposedPrComment(title, body, prNumber) {
   const sessionId = process.env.ASSIST_SESSION_ID;
   if (process.env.ASSIST_SESSION !== "1" || !sessionId) return;
   await awaitPreviewApproval("PR comment preview", {
     sessionId,
-    requestId: randomUUID9(),
+    requestId: randomUUID10(),
     title,
     body,
     prNumber,
@@ -22883,7 +22961,7 @@ async function comment2(path80, line, body, startLine) {
 }
 
 // src/commands/prs/edit.ts
-import { randomUUID as randomUUID10 } from "crypto";
+import { randomUUID as randomUUID11 } from "crypto";
 
 // src/commands/prs/appendScreenshots.ts
 function appendScreenshots(body, screenshots) {
@@ -22896,13 +22974,13 @@ ${screenshots.join("\n\n")}`;
 }
 
 // src/commands/prs/applyEdit.ts
-import { execFileSync as execFileSync8 } from "child_process";
+import { execFileSync as execFileSync9 } from "child_process";
 function applyEdit(number, title, body) {
   const args = ["pr", "edit", String(number)];
   if (title) args.push("--title", title);
   args.push("--body", body);
   try {
-    execFileSync8("gh", args, { stdio: "inherit" });
+    execFileSync9("gh", args, { stdio: "inherit" });
   } catch {
     process.exit(1);
   }
@@ -23053,24 +23131,7 @@ function isListLine(line) {
 
 // src/commands/prs/validatePrContent.ts
 function validatePrContent(title, body) {
-  if (title.toLowerCase().includes("claude")) {
-    console.error("Error: PR title must not reference Claude");
-    process.exit(1);
-  }
-  if (body.toLowerCase().includes("claude")) {
-    console.error("Error: PR body must not reference Claude");
-    process.exit(1);
-  }
-  const titleBacklogIds = findBacklogRefs(title);
-  if (titleBacklogIds.length > 0) {
-    console.error(backlogRefError("PR title", "PRs", titleBacklogIds));
-    process.exit(1);
-  }
-  const bodyBacklogIds = findBacklogRefs(body);
-  if (bodyBacklogIds.length > 0) {
-    console.error(backlogRefError("PR body", "PRs", bodyBacklogIds));
-    process.exit(1);
-  }
+  validateProposedContent({ subject: "PR", context: "PRs" }, title, body);
   const wall = findWallOfText(body);
   if (wall) {
     console.error(
@@ -23097,7 +23158,7 @@ async function edit(options2) {
   if (process.env.ASSIST_SESSION === "1" && sessionId) {
     const decision = await awaitPreviewApproval("PR preview", {
       sessionId,
-      requestId: randomUUID10(),
+      requestId: randomUUID11(),
       title: options2.title ?? title,
       body: newBody,
       prNumber: number
@@ -23715,7 +23776,7 @@ function buildValidatedBody(options2, usage) {
 }
 
 // src/commands/prs/placePr.ts
-import { execFileSync as execFileSync9 } from "child_process";
+import { execFileSync as execFileSync10 } from "child_process";
 
 // src/commands/prs/buildCreateArgs.ts
 function buildEditArgs(number, title, body) {
@@ -23782,7 +23843,7 @@ async function recordPrActivity() {
 // src/commands/prs/placePr.ts
 function hasUpstream2() {
   try {
-    execFileSync9(
+    execFileSync10(
       "git",
       ["rev-parse", "--abbrev-ref", "--symbolic-full-name", "@{u}"],
       { stdio: "pipe" }
@@ -23794,13 +23855,13 @@ function hasUpstream2() {
 }
 function ensureBranchPushed() {
   const args = hasUpstream2() ? ["push"] : ["push", "--set-upstream", "origin", "HEAD"];
-  execFileSync9("git", args, { stdio: "inherit" });
+  execFileSync10("git", args, { stdio: "inherit" });
 }
 async function placePr(prNumber, title, body, options2) {
   const args = prNumber !== null ? buildEditArgs(prNumber, title, body) : buildCreateArgs(title, body, options2);
   try {
     if (prNumber === null && !options2.head) ensureBranchPushed();
-    execFileSync9("gh", args, { stdio: "inherit" });
+    execFileSync10("gh", args, { stdio: "inherit" });
   } catch {
     process.exit(1);
   }
@@ -23808,7 +23869,7 @@ async function placePr(prNumber, title, body, options2) {
 }
 
 // src/commands/prs/previewAndPlace.ts
-import { randomUUID as randomUUID11 } from "crypto";
+import { randomUUID as randomUUID12 } from "crypto";
 
 // src/commands/sessions/shared/requestSession.ts
 function parseIncoming(line, type) {
@@ -23943,7 +24004,7 @@ function warn(reason4) {
 async function previewAndPlace(args) {
   const decision = await awaitPreviewApproval("PR preview", {
     sessionId: args.sessionId,
-    requestId: randomUUID11(),
+    requestId: randomUUID12(),
     title: args.title,
     body: args.body,
     prNumber: args.prNumber,
@@ -23963,9 +24024,9 @@ function resolveDraftState(options2, command) {
 }
 
 // src/commands/prs/raise.ts
-var USAGE = "Usage: assist prs raise --title <title> --what <what> --why <why> [--how <how>] [--resolves <key>] [--force]";
+var USAGE2 = "Usage: assist prs raise --title <title> --what <what> --why <why> [--how <how>] [--resolves <key>] [--force]";
 async function raise(options2, command) {
-  const { title, body } = buildValidatedBody(options2, USAGE);
+  const { title, body } = buildValidatedBody(options2, USAGE2);
   const resolved = { ...options2, draft: resolveDraftState(options2, command) };
   const existing = findCurrentPrNumber();
   const sessionId = process.env.ASSIST_SESSION_ID;
@@ -26426,10 +26487,10 @@ function registerRefactor(program2) {
 }
 
 // src/commands/review/checkoutOnlySession.ts
-import { randomUUID as randomUUID12 } from "crypto";
+import { randomUUID as randomUUID13 } from "crypto";
 async function checkoutOnlySession(number) {
   await checkoutPr(number);
-  const claudeSessionId = randomUUID12();
+  const claudeSessionId = randomUUID13();
   emitActivity({ kind: "command", name: "review", claudeSessionId });
   const { done: done2 } = spawnClaude("", {
     permissionMode: "acceptEdits",
@@ -30061,9 +30122,9 @@ function registerVoice(program2) {
 import { join as join83 } from "path";
 
 // src/commands/watch/resolveUpstream.ts
-import { execFileSync as execFileSync10 } from "child_process";
+import { execFileSync as execFileSync11 } from "child_process";
 function runGit2(args, cwd) {
-  return execFileSync10("git", args, {
+  return execFileSync11("git", args, {
     encoding: "utf8",
     stdio: ["pipe", "pipe", "pipe"],
     cwd
@@ -30424,13 +30485,13 @@ import { spawn as spawn9 } from "child_process";
 import { existsSync as existsSync68 } from "fs";
 
 // src/commands/run/resolveCommand.ts
-import { execFileSync as execFileSync11 } from "child_process";
+import { execFileSync as execFileSync12 } from "child_process";
 import { existsSync as existsSync67 } from "fs";
 import { dirname as dirname35, join as join84, resolve as resolve19 } from "path";
 function resolveCommand2(command) {
   if (process.platform !== "win32" || command !== "bash") return command;
   try {
-    const gitPath = execFileSync11("where", ["git"], { encoding: "utf8" }).trim().split("\r\n")[0];
+    const gitPath = execFileSync12("where", ["git"], { encoding: "utf8" }).trim().split("\r\n")[0];
     const gitRoot = resolve19(dirname35(gitPath), "..");
     const gitBash = join84(gitRoot, "bin", "bash.exe");
     if (existsSync67(gitBash)) return gitBash;
@@ -30527,11 +30588,11 @@ async function reportBuildOrExit(entry) {
 }
 
 // src/commands/watch/fetchQuietly.ts
-import { execFileSync as execFileSync12 } from "child_process";
+import { execFileSync as execFileSync13 } from "child_process";
 var MIN_FETCH_TIMEOUT_MS = 6e4;
 function fetchQuietly(cwd, intervalMs) {
   try {
-    execFileSync12("git", ["fetch", "--quiet"], {
+    execFileSync13("git", ["fetch", "--quiet"], {
       stdio: ["pipe", "pipe", "pipe"],
       cwd,
       timeout: Math.max(intervalMs, MIN_FETCH_TIMEOUT_MS)
@@ -30831,7 +30892,7 @@ async function auth() {
 }
 
 // src/commands/roam/postRoamActivity.ts
-import { execFileSync as execFileSync13 } from "child_process";
+import { execFileSync as execFileSync14 } from "child_process";
 import { readdirSync as readdirSync20, readFileSync as readFileSync52, statSync as statSync11 } from "fs";
 import { join as join85 } from "path";
 function findPortFile(roamDir) {
@@ -30864,7 +30925,7 @@ function postRoamActivity(app, event) {
   }
   const url = `http://127.0.0.1:${port}/api/v1/activity/${app}/${event}?pid=${app === "codex" ? 99998 : 99999}`;
   try {
-    execFileSync13("curl", ["-sf", "--max-time", "0.2", "-X", "POST", url], {
+    execFileSync14("curl", ["-sf", "--max-time", "0.2", "-X", "POST", url], {
       stdio: "ignore"
     });
   } catch {
@@ -31340,11 +31401,11 @@ function screenshot(processName) {
 }
 
 // src/commands/sessions/daemon/listDaemonPids.ts
-import { execFileSync as execFileSync14 } from "child_process";
+import { execFileSync as execFileSync15 } from "child_process";
 function listDaemonPids() {
   if (process.platform === "win32") return [];
   try {
-    const out = execFileSync14("ps", ["-eo", "pid=,args="], {
+    const out = execFileSync15("ps", ["-eo", "pid=,args="], {
       encoding: "utf8"
     });
     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));
@@ -31389,17 +31450,9 @@ function applyLine(result, pending, line) {
   }
 }
 
-// src/commands/sessions/daemon/reportStolenSocket.ts
+// src/commands/sessions/daemon/readDaemonPidFile.ts
 import { readFileSync as readFileSync53 } 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() {
+function readDaemonPidFile() {
   try {
     const pid = Number.parseInt(
       readFileSync53(daemonPaths.pid, "utf8").trim(),
@@ -31410,6 +31463,24 @@ function readPidFile() {
     return void 0;
   }
 }
+function isPidAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error) {
+    return error.code === "EPERM";
+  }
+}
+
+// src/commands/sessions/daemon/reportStolenSocket.ts
+function reportStolenSocket(socketPid) {
+  if (!socketPid) return;
+  const filePid = readDaemonPidFile();
+  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)`
+  );
+}
 
 // src/commands/sessions/daemon/daemonStatus.ts
 async function daemonStatus() {
@@ -31791,7 +31862,7 @@ var ClientHub = class extends Set {
 };
 
 // src/commands/sessions/daemon/createSession.ts
-import { randomUUID as randomUUID13 } from "crypto";
+import { randomUUID as randomUUID14 } from "crypto";
 
 // src/commands/sessions/daemon/sessionBase.ts
 function sessionBase(id, status3) {
@@ -31987,7 +32058,7 @@ function spawnRun(opts) {
 function createSession(id, { prompt, cwd, design, auto, harness, holdPty } = {}) {
   if (harness && harness !== "claude")
     return createHarnessSession(id, harness, prompt, cwd, holdPty);
-  const claudeSessionId = randomUUID13();
+  const claudeSessionId = randomUUID14();
   return {
     ...sessionBase(id, prompt ? "running" : "waiting"),
     name: `Session ${id}`,
@@ -32248,7 +32319,10 @@ function holdFailedDiscard(session, reason4, notify2) {
 // src/commands/sessions/daemon/killPtyTree.ts
 function killPtyTree(pty2) {
   if (process.platform === "win32") {
-    pty2.kill();
+    try {
+      pty2.kill();
+    } catch {
+    }
     return;
   }
   try {
@@ -32579,7 +32653,8 @@ var PREVIEW_KINDS = [
   "pr",
   "backlog-item",
   "backlog-comment",
-  "pr-comment"
+  "pr-comment",
+  "github-issue"
 ];
 function isPreviewKind(value) {
   return PREVIEW_KINDS.includes(value);
@@ -32589,6 +32664,7 @@ function isPreviewKind(value) {
 function previewTargetLabel(kind, itemType, prNumber, draft) {
   if (kind === "backlog-comment") return "backlog comment";
   if (kind === "pr-comment") return "pr comment";
+  if (kind === "github-issue") return "github issue";
   if (kind === "backlog-item") return `backlog ${itemType}`;
   if (prNumber !== null) return `edit #${prNumber}`;
   return draft ? "create draft" : "create";
@@ -34048,7 +34124,7 @@ function codexRespawnPlan(session) {
 }
 
 // src/commands/sessions/daemon/interactiveRespawnPlan.ts
-import { randomUUID as randomUUID14 } from "crypto";
+import { randomUUID as randomUUID15 } from "crypto";
 function interactiveRespawnPlan(session, resumes) {
   const { claudeSessionId, cwd, initialPrompt, design, auto } = session;
   if (!resumes) return null;
@@ -34068,7 +34144,7 @@ function interactiveRespawnPlan(session, resumes) {
   return null;
 }
 function freshClaudePlan(session, prompt, cwd) {
-  const claudeSessionId = randomUUID14();
+  const claudeSessionId = randomUUID15();
   return {
     spawn: () => {
       session.claudeSessionId = claudeSessionId;
@@ -34953,10 +35029,10 @@ function startReusedRunPty(session, assistArgs, itemId2, hold, clients, onStatus
 }
 
 // src/commands/sessions/daemon/createWatcherSession.ts
-import { randomUUID as randomUUID15 } from "crypto";
+import { randomUUID as randomUUID16 } from "crypto";
 var WATCH_PROMPT = "/watch";
 function createWatcherSession(id, cwd) {
-  const claudeSessionId = randomUUID15();
+  const claudeSessionId = randomUUID16();
   return {
     ...sessionBase(id, "running"),
     name: `Session ${id}`,
@@ -35145,9 +35221,23 @@ function reuseSessionForRun(session, itemId2, clients, onStatusChange, tree) {
 // src/commands/sessions/daemon/shutdownSessions.ts
 function shutdownSessions(sessions) {
   daemonLog(`shutting down: killing ${sessions.size} session(s)`);
+  let failures = 0;
   for (const session of sessions.values()) {
-    if (session.status !== "done") session.pty?.kill();
+    if (session.status === "done") continue;
+    try {
+      session.pty?.kill();
+    } catch (error) {
+      failures++;
+      const reason4 = error instanceof Error ? error.message : String(error);
+      daemonLog(
+        `shutting down: killing session ${session.name} (${session.id}) failed: ${reason4}`
+      );
+    }
   }
+  if (failures > 0)
+    daemonLog(
+      `shutting down: ${failures} session(s) failed to die; continuing so the process still exits and releases its listeners`
+    );
 }
 
 // src/commands/sessions/daemon/heldStartBlocked.ts
@@ -36648,8 +36738,13 @@ function handleFetchTranscript(client, _manager, data) {
   );
 }
 async function handleShutdown(client, manager) {
-  await manager.flushActiveMs();
-  manager.shutdown();
+  try {
+    await manager.flushActiveMs();
+    manager.shutdown();
+  } catch (error) {
+    const reason4 = error instanceof Error ? error.message : String(error);
+    daemonLog(`shutdown teardown failed: ${reason4}; exiting anyway`);
+  }
   sendTo(client, { type: "shutting-down" });
   setImmediate(() => process.exit(0));
 }
@@ -36840,7 +36935,12 @@ function onListening(manager, checkAutoExit) {
   startPidFileWatchdog(() => {
     daemonLog("lost daemon.pid ownership; shutting down sessions and exiting");
     void manager.flushActiveMs().finally(() => {
-      manager.shutdown();
+      try {
+        manager.shutdown();
+      } catch (error) {
+        const reason4 = error instanceof Error ? error.message : String(error);
+        daemonLog(`shutdown teardown failed: ${reason4}; exiting anyway`);
+      }
       process.exit(0);
     });
   });
@@ -36870,6 +36970,45 @@ function cleanupOwnedFiles() {
 
 // src/commands/sessions/daemon/startWindowsBridge.ts
 import * as net3 from "net";
+
+// src/commands/sessions/daemon/findPortHolderPid.ts
+import { execFileSync as execFileSync16 } from "child_process";
+var PROBE_TIMEOUT_MS = 3e3;
+function findPortHolderPid(port) {
+  try {
+    return process.platform === "win32" ? netstatListenerPid(probe("netstat", ["-ano"]), port) : firstPid(probe("lsof", ["-nP", `-iTCP:${port}`, "-sTCP:LISTEN", "-t"]));
+  } catch {
+    return void 0;
+  }
+}
+function probe(command, args) {
+  return execFileSync16(command, args, {
+    encoding: "utf8",
+    timeout: PROBE_TIMEOUT_MS,
+    stdio: ["ignore", "pipe", "ignore"]
+  });
+}
+function netstatListenerPid(output, port) {
+  const suffix = `:${port}`;
+  for (const line of output.split("\n")) {
+    const [protocol, local, , state, pid] = line.trim().split(/\s+/);
+    if (protocol?.toUpperCase() !== "TCP") continue;
+    if (state?.toUpperCase() !== "LISTENING") continue;
+    if (!local?.endsWith(suffix)) continue;
+    const holder = Number.parseInt(pid ?? "", 10);
+    if (Number.isInteger(holder)) return holder;
+  }
+  return void 0;
+}
+function firstPid(output) {
+  for (const line of output.split("\n")) {
+    const pid = Number.parseInt(line.trim(), 10);
+    if (Number.isInteger(pid)) return pid;
+  }
+  return void 0;
+}
+
+// src/commands/sessions/daemon/startWindowsBridge.ts
 var BIND_ATTEMPTS = 3;
 var BIND_RETRY_DELAY_MS = 250;
 var KEEPALIVE_PROBE_MS2 = 1e4;
@@ -36887,10 +37026,14 @@ async function startWindowsBridge(manager) {
     if (attempt < BIND_ATTEMPTS) await delay3(BIND_RETRY_DELAY_MS);
   }
   daemonLog(
-    `${WINDOWS_BRIDGE_FAILURE_PREFIX} could not bind port ${port} after ${BIND_ATTEMPTS} attempts; the port is held by another process or reserved by a Hyper-V/WSL dynamic port range \u2014 set sessions.windowsDaemonPort to a free port outside 49152-65535`
+    `${WINDOWS_BRIDGE_FAILURE_PREFIX} could not bind port ${port} after ${BIND_ATTEMPTS} attempts; ${describePortHolder(port)}`
   );
   return false;
 }
+function describePortHolder(port) {
+  const holder = findPortHolderPid(port);
+  return holder !== void 0 && holder !== process.pid ? `PID ${holder} is listening on it \u2014 kill PID ${holder} to free the port` : "the port is held by another process or reserved by a Hyper-V/WSL dynamic port range \u2014 set sessions.windowsDaemonPort to a free port outside 49152-65535";
+}
 function bindBridge(manager, port) {
   return new Promise((resolve24) => {
     const bridge = net3.createServer((socket) => {
@@ -36918,6 +37061,14 @@ function delay3(ms) {
   return new Promise((resolve24) => setTimeout(resolve24, ms));
 }
 
+// src/commands/sessions/daemon/describeWedgedHolder.ts
+function describeWedgedHolder() {
+  const recorded = readDaemonPidFile();
+  if (recorded !== void 0 && recorded !== process.pid && isPidAlive(recorded))
+    return `daemon.pid records PID ${recorded}, which is still alive \u2014 kill PID ${recorded} to free the pipe and the windows bridge port`;
+  return "the holding process could not be identified \u2014 look for a stray assist daemon and kill it";
+}
+
 // src/commands/sessions/daemon/startDaemonServer.ts
 async function startDaemonServer(manager, checkAutoExit) {
   if (process.platform === "win32" && !await startWindowsBridge(manager)) {
@@ -36950,12 +37101,17 @@ async function recoverFromAddrInUse(server, manager, checkAutoExit) {
     daemonLog("another daemon owns the socket; exiting");
     process.exit(1);
   }
+  if (process.platform === "win32") {
+    daemonLog(
+      `${daemonPaths.socket} is bound but not answering: ${describeWedgedHolder()}; a named pipe cannot be removed, so exiting instead of retrying the bind`
+    );
+    exitAfterFlush(1);
+    return;
+  }
   daemonLog("removing stale socket left by a crashed daemon");
-  if (process.platform !== "win32") {
-    try {
-      unlinkSync24(daemonPaths.socket);
-    } catch {
-    }
+  try {
+    unlinkSync24(daemonPaths.socket);
+  } catch {
   }
   listenWithSingleOnListening(server, manager, checkAutoExit);
 }
@@ -37033,7 +37189,7 @@ function summaryPathFor(jsonlPath2) {
 }
 
 // src/commands/sessions/summarise/summariseSession.ts
-import { execFileSync as execFileSync15 } from "child_process";
+import { execFileSync as execFileSync17 } from "child_process";
 function summariseSession(jsonlPath2) {
   const firstMessage = extractFirstUserMessage(jsonlPath2);
   const backlogIds = scanSessionBacklogRefs(jsonlPath2);
@@ -37042,7 +37198,7 @@ function summariseSession(jsonlPath2) {
   }
   const prompt = buildPrompt6(firstMessage, backlogIds);
   try {
-    const output = execFileSync15("claude", ["-p", "--model", "haiku", prompt], {
+    const output = execFileSync17("claude", ["-p", "--model", "haiku", prompt], {
       encoding: "utf8",
       timeout: 3e4,
       stdio: ["ignore", "pipe", "ignore"]