npm - @staff0rd/assist - Versions diffs - 0.572.0 → 0.573.0 - Mend

@staff0rd/assist 0.572.0 → 0.573.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/README.md +1 -0
package/claude/commands/github.md +4 -4
package/dist/commands/sessions/web/bundle.js +2 -2
package/dist/index.js +269 -107
package/package.json +1 -1

package/dist/index.js CHANGED Viewed

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.572.0",
+  version: "0.573.0",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -16726,6 +16726,10 @@ var BUILTIN_DENIES = [
     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: "gh issue comment",
+    message: "Do not run 'gh issue comment' directly. Use 'assist github issue comment <number> --body <body> [-R <owner>/<repo>]' instead \u2014 it validates the body before delegating to gh, and gates the comment on the user's approval itself. Run 'assist github issue comment --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.`
@@ -20629,7 +20633,29 @@ function commits(org, options2) {
   }
 }
-// src/commands/github/issue/createIssue.ts
+// src/commands/github/parseSinceDate.ts
+import { InvalidArgumentError } from "commander";
+function parseSinceDate(value) {
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) {
+    throw new InvalidArgumentError("Expected a date in YYYY-MM-DD format.");
+  }
+  const date = /* @__PURE__ */ new Date(`${value}T00:00:00Z`);
+  if (Number.isNaN(date.getTime()) || date.toISOString().slice(0, 10) !== value) {
+    throw new InvalidArgumentError(`Not a valid calendar date: ${value}.`);
+  }
+  return value;
+}
+// src/commands/github/parseTopCount.ts
+import { InvalidArgumentError as InvalidArgumentError2 } from "commander";
+function parseTopCount(value) {
+  if (!/^\d+$/.test(value) || Number.parseInt(value, 10) < 1) {
+    throw new InvalidArgumentError2("Expected a positive integer.");
+  }
+  return Number.parseInt(value, 10);
+}
+// src/commands/github/issue/commentIssue.ts
 import { execFileSync as execFileSync6 } from "child_process";
 // src/shared/validateProposedContent.ts
@@ -20657,14 +20683,58 @@ function validateProposedContent(labels, title, body) {
   }
 }
-// src/commands/github/issue/reviewProposedIssue.ts
+// src/commands/github/issue/reviewProposedIssueComment.ts
 import { randomUUID as randomUUID7 } from "crypto";
+async function reviewProposedIssueComment(title, body) {
+  const sessionId = process.env.ASSIST_SESSION_ID;
+  if (process.env.ASSIST_SESSION !== "1" || !sessionId) return;
+  await awaitPreviewApproval("GitHub issue comment preview", {
+    sessionId,
+    requestId: randomUUID7(),
+    title,
+    body,
+    prNumber: null,
+    kind: "github-issue-comment"
+  });
+}
+// src/commands/github/issue/commentIssue.ts
+var USAGE = "Usage: assist github issue comment <number> --body <body> [-R <owner>/<repo>]";
+async function commentIssue(numberArg, options2) {
+  const number = Number.parseInt(numberArg, 10);
+  if (!Number.isInteger(number) || number <= 0 || !options2.body) {
+    console.error(USAGE);
+    process.exit(1);
+  }
+  const { body } = options2;
+  const target = options2.repo ? `${options2.repo}#${number}` : `issue #${number}`;
+  validateProposedContent(
+    { subject: "Comment", context: "GitHub issues" },
+    "",
+    body
+  );
+  await reviewProposedIssueComment(`Comment on ${target}`, body);
+  const args = ["issue", "comment", String(number), "--body", body];
+  if (options2.repo) args.push("--repo", options2.repo);
+  try {
+    execFileSync6("gh", args, { stdio: "inherit" });
+  } catch {
+    process.exit(1);
+  }
+  console.log(`Comment posted to ${target}`);
+}
+// src/commands/github/issue/createIssue.ts
+import { execFileSync as execFileSync7 } from "child_process";
+// src/commands/github/issue/reviewProposedIssue.ts
+import { randomUUID as randomUUID8 } 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(),
+    requestId: randomUUID8(),
     title,
     body,
     prNumber: null,
@@ -20673,10 +20743,10 @@ async function reviewProposedIssue(title, body) {
 }
 // src/commands/github/issue/createIssue.ts
-var USAGE = "Usage: assist github issue create --title <title> --body <body> [-R <owner>/<repo>]";
+var USAGE2 = "Usage: assist github issue create --title <title> --body <body> [-R <owner>/<repo>]";
 async function createIssue(options2) {
   if (!options2.title || !options2.body) {
-    console.error(USAGE);
+    console.error(USAGE2);
     process.exit(1);
   }
   const { title, body } = options2;
@@ -20689,32 +20759,47 @@ async function createIssue(options2) {
   const args = ["issue", "create", "--title", title, "--body", body];
   if (options2.repo) args.push("--repo", options2.repo);
   try {
-    execFileSync6("gh", args, { stdio: "inherit" });
+    execFileSync7("gh", args, { stdio: "inherit" });
   } catch {
     process.exit(1);
   }
 }
-// src/commands/github/parseSinceDate.ts
-import { InvalidArgumentError } from "commander";
-function parseSinceDate(value) {
-  if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) {
-    throw new InvalidArgumentError("Expected a date in YYYY-MM-DD format.");
-  }
-  const date = /* @__PURE__ */ new Date(`${value}T00:00:00Z`);
-  if (Number.isNaN(date.getTime()) || date.toISOString().slice(0, 10) !== value) {
-    throw new InvalidArgumentError(`Not a valid calendar date: ${value}.`);
+// src/commands/prs/readBodyArgument.ts
+async function readBodyArgument(value) {
+  if (value !== "-") return value;
+  const body = (await readStdinBuffer()).toString("utf8").replace(/\n+$/, "");
+  if (body.trim().length === 0) {
+    console.error("Error: No body was provided on stdin.");
+    process.exit(1);
   }
-  return value;
+  return body;
 }
-// src/commands/github/parseTopCount.ts
-import { InvalidArgumentError as InvalidArgumentError2 } from "commander";
-function parseTopCount(value) {
-  if (!/^\d+$/.test(value) || Number.parseInt(value, 10) < 1) {
-    throw new InvalidArgumentError2("Expected a positive integer.");
-  }
-  return Number.parseInt(value, 10);
+// src/commands/registerGithubIssue.ts
+function registerGithubIssue(githubCommand) {
+  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);
+  issueCommand.command("comment <number>").description("Comment on a GitHub issue (body of - reads it from stdin)").option("--body <body>", "Comment body (- reads it from stdin)").option(
+    "-R, --repo <owner/repo>",
+    "Target repository (defaults to the current repo)"
+  ).addHelpText(
+    "after",
+    "\nThe comment is outward-facing: write it for the repo's readers, not the team. It is rejected if it references Claude or an assist backlog item.\nIn an assist web session the body is previewed for approve/reject first (with inline comments); nothing is posted until it is approved."
+  ).action(
+    async (number, options2) => {
+      await commentIssue(number, {
+        ...options2,
+        body: options2.body ? await readBodyArgument(options2.body) : void 0
+      });
+    }
+  );
 }
 // src/commands/registerGithub.ts
@@ -20729,14 +20814,7 @@ 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);
+  registerGithubIssue(githubCommand);
 }
 // src/commands/handover/countPendingHandovers.ts
@@ -21146,10 +21224,10 @@ function registerRefineLaunch(program2, resumeFlag) {
 }
 // src/commands/reviewPrComments.ts
-import { randomUUID as randomUUID8 } from "crypto";
+import { randomUUID as randomUUID9 } from "crypto";
 // src/commands/review/checkoutPr.ts
-import { execFileSync as execFileSync8 } from "child_process";
+import { execFileSync as execFileSync9 } from "child_process";
 import chalk164 from "chalk";
 // src/commands/sessions/daemon/daemonLog.ts
@@ -21709,10 +21787,10 @@ async function moveToPrCheckoutTree() {
 }
 // src/commands/review/prHeadBranch.ts
-import { execFileSync as execFileSync7 } from "child_process";
+import { execFileSync as execFileSync8 } from "child_process";
 function prHeadBranch(number) {
   try {
-    const out = execFileSync7(
+    const out = execFileSync8(
       "gh",
       ["pr", "view", number, "--json", "headRefName", "-q", ".headRefName"],
       { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }
@@ -21760,7 +21838,7 @@ async function checkoutPr(number) {
   if (headRef && moveToExistingCheckout(number, headRef)) return;
   await moveToPrCheckoutTree();
   try {
-    execFileSync8("gh", ["pr", "checkout", number], { stdio: "inherit" });
+    execFileSync9("gh", ["pr", "checkout", number], { stdio: "inherit" });
   } catch {
     console.error(chalk164.red(`gh pr checkout ${number} failed; aborting.`));
     process.exit(1);
@@ -21782,7 +21860,7 @@ async function reviewPrComments(number, options2 = {}) {
   const resumeSessionId = options2.resumeSessionId;
   validateAnnounce(number, announce);
   if (number && !resumeSessionId) await checkoutPr(number);
-  const claudeSessionId = resumeSessionId ?? randomUUID8();
+  const claudeSessionId = resumeSessionId ?? randomUUID9();
   emitActivity({
     kind: "command",
     name: "review-pr-comments",
@@ -21800,14 +21878,14 @@ async function reviewPrComments(number, options2 = {}) {
 }
 // src/commands/fixConflict.ts
-import { randomUUID as randomUUID9 } from "crypto";
+import { randomUUID as randomUUID10 } 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 ?? randomUUID9();
+  const claudeSessionId = resumeSessionId ?? randomUUID10();
   emitActivity({
     kind: "command",
     name: "fix-conflict",
@@ -22829,13 +22907,13 @@ function postReviewComment(vars) {
 }
 // src/commands/prs/reviewProposedPrComment.ts
-import { randomUUID as randomUUID10 } from "crypto";
+import { randomUUID as randomUUID11 } 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: randomUUID10(),
+    requestId: randomUUID11(),
     title,
     body,
     prNumber,
@@ -22961,7 +23039,7 @@ async function comment2(path80, line, body, startLine) {
 }
 // src/commands/prs/edit.ts
-import { randomUUID as randomUUID11 } from "crypto";
+import { randomUUID as randomUUID12 } from "crypto";
 // src/commands/prs/appendScreenshots.ts
 function appendScreenshots(body, screenshots) {
@@ -22974,13 +23052,13 @@ ${screenshots.join("\n\n")}`;
 }
 // src/commands/prs/applyEdit.ts
-import { execFileSync as execFileSync9 } from "child_process";
+import { execFileSync as execFileSync10 } 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 {
-    execFileSync9("gh", args, { stdio: "inherit" });
+    execFileSync10("gh", args, { stdio: "inherit" });
   } catch {
     process.exit(1);
   }
@@ -23158,7 +23236,7 @@ async function edit(options2) {
   if (process.env.ASSIST_SESSION === "1" && sessionId) {
     const decision = await awaitPreviewApproval("PR preview", {
       sessionId,
-      requestId: randomUUID11(),
+      requestId: randomUUID12(),
       title: options2.title ?? title,
       body: newBody,
       prNumber: number
@@ -23776,7 +23854,7 @@ function buildValidatedBody(options2, usage) {
 }
 // src/commands/prs/placePr.ts
-import { execFileSync as execFileSync10 } from "child_process";
+import { execFileSync as execFileSync11 } from "child_process";
 // src/commands/prs/buildCreateArgs.ts
 function buildEditArgs(number, title, body) {
@@ -23843,7 +23921,7 @@ async function recordPrActivity() {
 // src/commands/prs/placePr.ts
 function hasUpstream2() {
   try {
-    execFileSync10(
+    execFileSync11(
       "git",
       ["rev-parse", "--abbrev-ref", "--symbolic-full-name", "@{u}"],
       { stdio: "pipe" }
@@ -23855,13 +23933,13 @@ function hasUpstream2() {
 }
 function ensureBranchPushed() {
   const args = hasUpstream2() ? ["push"] : ["push", "--set-upstream", "origin", "HEAD"];
-  execFileSync10("git", args, { stdio: "inherit" });
+  execFileSync11("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();
-    execFileSync10("gh", args, { stdio: "inherit" });
+    execFileSync11("gh", args, { stdio: "inherit" });
   } catch {
     process.exit(1);
   }
@@ -23869,7 +23947,7 @@ async function placePr(prNumber, title, body, options2) {
 }
 // src/commands/prs/previewAndPlace.ts
-import { randomUUID as randomUUID12 } from "crypto";
+import { randomUUID as randomUUID13 } from "crypto";
 // src/commands/sessions/shared/requestSession.ts
 function parseIncoming(line, type) {
@@ -24004,7 +24082,7 @@ function warn(reason4) {
 async function previewAndPlace(args) {
   const decision = await awaitPreviewApproval("PR preview", {
     sessionId: args.sessionId,
-    requestId: randomUUID12(),
+    requestId: randomUUID13(),
     title: args.title,
     body: args.body,
     prNumber: args.prNumber,
@@ -24024,9 +24102,9 @@ function resolveDraftState(options2, command) {
 }
 // src/commands/prs/raise.ts
-var USAGE2 = "Usage: assist prs raise --title <title> --what <what> --why <why> [--how <how>] [--resolves <key>] [--force]";
+var USAGE3 = "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, USAGE2);
+  const { title, body } = buildValidatedBody(options2, USAGE3);
   const resolved = { ...options2, draft: resolveDraftState(options2, command) };
   const existing = findCurrentPrNumber();
   const sessionId = process.env.ASSIST_SESSION_ID;
@@ -24125,17 +24203,6 @@ async function wontfix(commentId, reason4) {
   }
 }
-// src/commands/prs/readBodyArgument.ts
-async function readBodyArgument(value) {
-  if (value !== "-") return value;
-  const body = (await readStdinBuffer()).toString("utf8").replace(/\n+$/, "");
-  if (body.trim().length === 0) {
-    console.error("Error: No body was provided on stdin.");
-    process.exit(1);
-  }
-  return body;
-}
 // src/commands/registerPrsComments.ts
 function registerPrsComments(prsCommand) {
   prsCommand.command("list-comments").description("List all comments on the current branch's pull request").action(() => {
@@ -26487,10 +26554,10 @@ function registerRefactor(program2) {
 }
 // src/commands/review/checkoutOnlySession.ts
-import { randomUUID as randomUUID13 } from "crypto";
+import { randomUUID as randomUUID14 } from "crypto";
 async function checkoutOnlySession(number) {
   await checkoutPr(number);
-  const claudeSessionId = randomUUID13();
+  const claudeSessionId = randomUUID14();
   emitActivity({ kind: "command", name: "review", claudeSessionId });
   const { done: done2 } = spawnClaude("", {
     permissionMode: "acceptEdits",
@@ -30122,9 +30189,9 @@ function registerVoice(program2) {
 import { join as join83 } from "path";
 // src/commands/watch/resolveUpstream.ts
-import { execFileSync as execFileSync11 } from "child_process";
+import { execFileSync as execFileSync12 } from "child_process";
 function runGit2(args, cwd) {
-  return execFileSync11("git", args, {
+  return execFileSync12("git", args, {
     encoding: "utf8",
     stdio: ["pipe", "pipe", "pipe"],
     cwd
@@ -30485,13 +30552,13 @@ import { spawn as spawn9 } from "child_process";
 import { existsSync as existsSync68 } from "fs";
 // src/commands/run/resolveCommand.ts
-import { execFileSync as execFileSync12 } from "child_process";
+import { execFileSync as execFileSync13 } 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 = execFileSync12("where", ["git"], { encoding: "utf8" }).trim().split("\r\n")[0];
+    const gitPath = execFileSync13("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;
@@ -30588,11 +30655,11 @@ async function reportBuildOrExit(entry) {
 }
 // src/commands/watch/fetchQuietly.ts
-import { execFileSync as execFileSync13 } from "child_process";
+import { execFileSync as execFileSync14 } from "child_process";
 var MIN_FETCH_TIMEOUT_MS = 6e4;
 function fetchQuietly(cwd, intervalMs) {
   try {
-    execFileSync13("git", ["fetch", "--quiet"], {
+    execFileSync14("git", ["fetch", "--quiet"], {
       stdio: ["pipe", "pipe", "pipe"],
       cwd,
       timeout: Math.max(intervalMs, MIN_FETCH_TIMEOUT_MS)
@@ -30892,7 +30959,7 @@ async function auth() {
 }
 // src/commands/roam/postRoamActivity.ts
-import { execFileSync as execFileSync14 } from "child_process";
+import { execFileSync as execFileSync15 } from "child_process";
 import { readdirSync as readdirSync20, readFileSync as readFileSync52, statSync as statSync11 } from "fs";
 import { join as join85 } from "path";
 function findPortFile(roamDir) {
@@ -30925,7 +30992,7 @@ function postRoamActivity(app, event) {
   }
   const url = `http://127.0.0.1:${port}/api/v1/activity/${app}/${event}?pid=${app === "codex" ? 99998 : 99999}`;
   try {
-    execFileSync14("curl", ["-sf", "--max-time", "0.2", "-X", "POST", url], {
+    execFileSync15("curl", ["-sf", "--max-time", "0.2", "-X", "POST", url], {
       stdio: "ignore"
     });
   } catch {
@@ -31401,11 +31468,11 @@ function screenshot(processName) {
 }
 // src/commands/sessions/daemon/listDaemonPids.ts
-import { execFileSync as execFileSync15 } from "child_process";
+import { execFileSync as execFileSync16 } from "child_process";
 function listDaemonPids() {
   if (process.platform === "win32") return [];
   try {
-    const out = execFileSync15("ps", ["-eo", "pid=,args="], {
+    const out = execFileSync16("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));
@@ -31450,17 +31517,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(),
@@ -31471,6 +31530,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() {
@@ -31852,7 +31929,7 @@ var ClientHub = class extends Set {
 };
 // src/commands/sessions/daemon/createSession.ts
-import { randomUUID as randomUUID14 } from "crypto";
+import { randomUUID as randomUUID15 } from "crypto";
 // src/commands/sessions/daemon/sessionBase.ts
 function sessionBase(id, status3) {
@@ -32048,7 +32125,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 = randomUUID14();
+  const claudeSessionId = randomUUID15();
   return {
     ...sessionBase(id, prompt ? "running" : "waiting"),
     name: `Session ${id}`,
@@ -32309,7 +32386,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 {
@@ -32641,7 +32721,8 @@ var PREVIEW_KINDS = [
   "backlog-item",
   "backlog-comment",
   "pr-comment",
-  "github-issue"
+  "github-issue",
+  "github-issue-comment"
 ];
 function isPreviewKind(value) {
   return PREVIEW_KINDS.includes(value);
@@ -32651,6 +32732,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-comment") return "github issue comment";
   if (kind === "github-issue") return "github issue";
   if (kind === "backlog-item") return `backlog ${itemType}`;
   if (prNumber !== null) return `edit #${prNumber}`;
@@ -34111,7 +34193,7 @@ function codexRespawnPlan(session) {
 }
 // src/commands/sessions/daemon/interactiveRespawnPlan.ts
-import { randomUUID as randomUUID15 } from "crypto";
+import { randomUUID as randomUUID16 } from "crypto";
 function interactiveRespawnPlan(session, resumes) {
   const { claudeSessionId, cwd, initialPrompt, design, auto } = session;
   if (!resumes) return null;
@@ -34131,7 +34213,7 @@ function interactiveRespawnPlan(session, resumes) {
   return null;
 }
 function freshClaudePlan(session, prompt, cwd) {
-  const claudeSessionId = randomUUID15();
+  const claudeSessionId = randomUUID16();
   return {
     spawn: () => {
       session.claudeSessionId = claudeSessionId;
@@ -35016,10 +35098,10 @@ function startReusedRunPty(session, assistArgs, itemId2, hold, clients, onStatus
 }
 // src/commands/sessions/daemon/createWatcherSession.ts
-import { randomUUID as randomUUID16 } from "crypto";
+import { randomUUID as randomUUID17 } from "crypto";
 var WATCH_PROMPT = "/watch";
 function createWatcherSession(id, cwd) {
-  const claudeSessionId = randomUUID16();
+  const claudeSessionId = randomUUID17();
   return {
     ...sessionBase(id, "running"),
     name: `Session ${id}`,
@@ -35208,9 +35290,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
@@ -36711,8 +36807,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));
 }
@@ -36903,7 +37004,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);
     });
   });
@@ -36933,6 +37039,45 @@ function cleanupOwnedFiles() {
 // src/commands/sessions/daemon/startWindowsBridge.ts
 import * as net3 from "net";
+// src/commands/sessions/daemon/findPortHolderPid.ts
+import { execFileSync as execFileSync17 } 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 execFileSync17(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;
@@ -36950,10 +37095,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) => {
@@ -36981,6 +37130,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)) {
@@ -37013,12 +37170,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);
 }
@@ -37096,7 +37258,7 @@ function summaryPathFor(jsonlPath2) {
 }
 // src/commands/sessions/summarise/summariseSession.ts
-import { execFileSync as execFileSync16 } from "child_process";
+import { execFileSync as execFileSync18 } from "child_process";
 function summariseSession(jsonlPath2) {
   const firstMessage = extractFirstUserMessage(jsonlPath2);
   const backlogIds = scanSessionBacklogRefs(jsonlPath2);
@@ -37105,7 +37267,7 @@ function summariseSession(jsonlPath2) {
   }
   const prompt = buildPrompt6(firstMessage, backlogIds);
   try {
-    const output = execFileSync16("claude", ["-p", "--model", "haiku", prompt], {
+    const output = execFileSync18("claude", ["-p", "--model", "haiku", prompt], {
       encoding: "utf8",
       timeout: 3e4,
       stdio: ["ignore", "pipe", "ignore"]