@staff0rd/assist 0.428.1 → 0.429.0

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.428.1",
+  version: "0.429.0",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -9291,6 +9291,132 @@ async function restartWeb(req, res, deps2 = {}) {
   }
 }
 
+// src/commands/sessions/web/uploadPrImage.ts
+import { rm } from "fs/promises";
+
+// src/commands/sessions/web/runGhImage.ts
+import { execFile as execFile6 } from "child_process";
+import { promisify as promisify7 } from "util";
+var execFileAsync6 = promisify7(execFile6);
+var GhImageUnavailableError = class extends Error {
+  name = "GhImageUnavailableError";
+};
+var GH_IMAGE_INSTALL_COMMAND = "gh extension install drogers0/gh-image";
+var INSTALL_HINT = `Install the gh-image extension: ${GH_IMAGE_INSTALL_COMMAND}`;
+async function runGhImage(filePath, cwd) {
+  let stdout;
+  try {
+    ({ stdout } = await execFileAsync6("gh", ["image", filePath], {
+      cwd,
+      maxBuffer: 10 * 1024 * 1024
+    }));
+  } catch (error) {
+    const err = error;
+    if (err.code === "ENOENT")
+      throw new GhImageUnavailableError(
+        `The GitHub CLI (\`gh\`) is not installed. ${INSTALL_HINT}`
+      );
+    const stderr = err.stderr ?? "";
+    if (/unknown command "image"/i.test(stderr) || /extension.*not found/i.test(stderr))
+      throw new GhImageUnavailableError(
+        `The \`gh-image\` extension is not installed. ${INSTALL_HINT}`
+      );
+    throw new Error(
+      `gh image failed: ${stderr.trim() || err.message || "unknown error"}`
+    );
+  }
+  const lines = stdout.split("\n").map((line) => line.trim()).filter(Boolean);
+  const markdown = lines.find((line) => /^!\[.*]\(.+\)$/.test(line)) ?? lines.find((line) => line.includes("http")) ?? lines[0];
+  if (!markdown) throw new Error("gh image produced no output");
+  return markdown;
+}
+
+// src/commands/sessions/web/readRequestBuffer.ts
+async function readRequestBuffer(req, limit) {
+  const chunks = [];
+  let size = 0;
+  for await (const chunk of req) {
+    const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+    size += buf.length;
+    if (size > limit) {
+      req.destroy();
+      return null;
+    }
+    chunks.push(buf);
+  }
+  return Buffer.concat(chunks);
+}
+
+// src/commands/sessions/web/writeTempImage.ts
+import { mkdtemp, writeFile as writeFile2 } from "fs/promises";
+import { tmpdir } from "os";
+import { extname, join as join28 } from "path";
+var EXT_BY_MIME = {
+  "image/png": "png",
+  "image/jpeg": "jpg",
+  "image/gif": "gif",
+  "image/webp": "webp",
+  "image/svg+xml": "svg",
+  "image/bmp": "bmp",
+  "image/avif": "avif"
+};
+function pickExtension(name, contentType) {
+  const fromName = extname(name).replace(/^\./, "").toLowerCase();
+  if (fromName) return fromName;
+  return EXT_BY_MIME[contentType.split(";")[0].trim().toLowerCase()] ?? "png";
+}
+function safeBaseName(name) {
+  const base = name.replace(/\.[^.]+$/, "").replace(/[^a-zA-Z0-9_-]+/g, "-");
+  return base.replace(/^-+|-+$/g, "").slice(0, 60) || "screenshot";
+}
+async function writeTempImage(name, contentType, body) {
+  const dir = await mkdtemp(join28(tmpdir(), "assist-pr-img-"));
+  const filePath = join28(
+    dir,
+    `${safeBaseName(name)}.${pickExtension(name, contentType)}`
+  );
+  await writeFile2(filePath, body);
+  return { dir, filePath };
+}
+
+// src/commands/sessions/web/uploadPrImage.ts
+var MAX_BYTES = 25 * 1024 * 1024;
+async function uploadPrImage(req, res) {
+  const cwd = getCwdParam(req, res);
+  if (!cwd) return;
+  const url = new URL(req.url ?? "/", "http://localhost");
+  const name = url.searchParams.get("name") ?? "";
+  const contentType = req.headers["content-type"] ?? "";
+  const body = await readRequestBuffer(req, MAX_BYTES);
+  if (!body) {
+    respondJson(res, 413, { error: "Image too large (max 25MB)." });
+    return;
+  }
+  if (body.length === 0) {
+    respondJson(res, 400, { error: "Empty upload." });
+    return;
+  }
+  const { dir, filePath } = await writeTempImage(name, contentType, body);
+  try {
+    const markdown = await runGhImage(filePath, cwd);
+    respondJson(res, 200, { markdown });
+  } catch (error) {
+    if (error instanceof GhImageUnavailableError) {
+      respondJson(res, 501, {
+        error: error.message,
+        command: GH_IMAGE_INSTALL_COMMAND
+      });
+    } else {
+      respondJson(res, 500, {
+        error: error instanceof Error ? error.message : "Upload failed"
+      });
+    }
+  } finally {
+    await rm(dir, { recursive: true, force: true }).catch(() => {
+    });
+  }
+}
+
 // src/commands/sessions/web/createCssHandler.ts
 import { createHash as createHash2 } from "crypto";
 import { readFileSync as readFileSync21 } from "fs";
@@ -9333,6 +9459,7 @@ var routes2 = {
   "GET /api/items": listItems,
   "GET /api/backlog/summary": getBacklogSummary,
   "POST /api/open-in-code": openInCode,
+  "POST /api/pr-preview/upload-image": uploadPrImage,
   "POST /api/restart": restartWeb,
   "GET /api/github-url": githubUrl,
   "GET /api/git-status": gitStatus,
@@ -10390,8 +10517,8 @@ function ensureRemoteOrigin() {
 // src/commands/backlog/add/shared.ts
 import { spawnSync as spawnSync3 } from "child_process";
 import { mkdtempSync, readFileSync as readFileSync22, unlinkSync as unlinkSync6, writeFileSync as writeFileSync21 } from "fs";
-import { tmpdir } from "os";
-import { join as join28 } from "path";
+import { tmpdir as tmpdir2 } from "os";
+import { join as join29 } from "path";
 import enquirer6 from "enquirer";
 async function promptType() {
   const { type } = await enquirer6.prompt({
@@ -10431,8 +10558,8 @@ async function promptDescription() {
 }
 function openEditor() {
   const editor = process.env.EDITOR || process.env.VISUAL || "vi";
-  const dir = mkdtempSync(join28(tmpdir(), "assist-"));
-  const filePath = join28(dir, "description.md");
+  const dir = mkdtempSync(join29(tmpdir2(), "assist-"));
+  const filePath = join29(dir, "description.md");
   writeFileSync21(filePath, "");
   const result = spawnSync3(editor, [filePath], { stdio: "inherit" });
   if (result.status !== 0) {
@@ -12065,7 +12192,7 @@ import { basename as basename7 } from "path";
 import { parse } from "shell-quote";
 
 // src/shared/consumeRedirect.ts
-import { tmpdir as tmpdir2 } from "os";
+import { tmpdir as tmpdir3 } from "os";
 
 // src/shared/isRedirectTargetAllowed.ts
 function isRedirectTargetAllowed(target, tmp) {
@@ -12093,7 +12220,7 @@ function consumeRedirect(tokens, opIndex, current) {
   if (typeof target !== "string") {
     return { ok: false, error: "unable to parse" };
   }
-  if (!isRedirectTargetAllowed(target, tmpdir2())) {
+  if (!isRedirectTargetAllowed(target, tmpdir3())) {
     return {
       ok: false,
       error: `redirect target '${target}' is outside the OS temp directory`
@@ -12384,12 +12511,12 @@ function findCliWrite(command) {
 // src/shared/readSettingsPerms.ts
 import { existsSync as existsSync30, readFileSync as readFileSync24 } from "fs";
 import { homedir as homedir14 } from "os";
-import { join as join29 } from "path";
+import { join as join30 } from "path";
 function readSettingsPerms(key) {
   const paths = [
-    join29(homedir14(), ".claude", "settings.json"),
-    join29(process.cwd(), ".claude", "settings.json"),
-    join29(process.cwd(), ".claude", "settings.local.json")
+    join30(homedir14(), ".claude", "settings.json"),
+    join30(process.cwd(), ".claude", "settings.json"),
+    join30(process.cwd(), ".claude", "settings.local.json")
   ];
   const entries = [];
   for (const p of paths) {
@@ -12591,11 +12718,11 @@ function decideCommand(toolName, rawCommand) {
 // src/commands/cliHook/logDeniedToolCall.ts
 import { mkdirSync as mkdirSync12 } from "fs";
 import { homedir as homedir15 } from "os";
-import { join as join30 } from "path";
+import { join as join31 } from "path";
 import Database from "better-sqlite3";
 var _db;
 function getDbDir() {
-  return join30(homedir15(), ".assist");
+  return join31(homedir15(), ".assist");
 }
 function initSchema(db) {
   db.exec(`
@@ -12614,7 +12741,7 @@ function openPromptsDb(dir) {
   if (_db) return _db;
   const dbDir = dir ?? getDbDir();
   mkdirSync12(dbDir, { recursive: true });
-  const db = new Database(join30(dbDir, "assist.db"));
+  const db = new Database(join31(dbDir, "assist.db"));
   db.pragma("journal_mode = WAL");
   initSchema(db);
   _db = db;
@@ -12712,7 +12839,7 @@ ${reasons.join("\n")}`);
 // src/commands/permitCliReads/index.ts
 import { existsSync as existsSync31, mkdirSync as mkdirSync13, readFileSync as readFileSync25, writeFileSync as writeFileSync23 } from "fs";
 import { homedir as homedir16 } from "os";
-import { join as join31 } from "path";
+import { join as join32 } from "path";
 
 // src/commands/permitCliReads/assertCliExists.ts
 function assertCliExists(cli) {
@@ -12980,7 +13107,7 @@ function updateSettings(cli, commands) {
 // src/commands/permitCliReads/index.ts
 function logPath(cli) {
   const safeName = cli.replace(/\s+/g, "-");
-  return join31(homedir16(), ".assist", `cli-discover-${safeName}.log`);
+  return join32(homedir16(), ".assist", `cli-discover-${safeName}.log`);
 }
 function readCache(cli) {
   const path71 = logPath(cli);
@@ -12988,7 +13115,7 @@ function readCache(cli) {
   return readFileSync25(path71, "utf8");
 }
 function writeCache(cli, output) {
-  const dir = join31(homedir16(), ".assist");
+  const dir = join32(homedir16(), ".assist");
   mkdirSync13(dir, { recursive: true });
   writeFileSync23(logPath(cli), output);
 }
@@ -13136,17 +13263,17 @@ import chalk113 from "chalk";
 
 // src/commands/codeComment/getRestrictedDir.ts
 import { homedir as homedir17 } from "os";
-import { join as join32 } from "path";
+import { join as join33 } from "path";
 function getRestrictedDir() {
-  return join32(homedir17(), ".assist", "restricted");
+  return join33(homedir17(), ".assist", "restricted");
 }
 function getPinStatePath(pin) {
-  return join32(getRestrictedDir(), `code-comment-${pin}.json`);
+  return join33(getRestrictedDir(), `code-comment-${pin}.json`);
 }
 
 // src/commands/codeComment/sweepRestrictedDir.ts
 import { readdirSync as readdirSync3, statSync as statSync3, unlinkSync as unlinkSync7 } from "fs";
-import { join as join33 } from "path";
+import { join as join34 } from "path";
 var STALE_AFTER_MS = 30 * 60 * 1e3;
 function sweepRestrictedDir(dir = getRestrictedDir()) {
   let entries;
@@ -13157,7 +13284,7 @@ function sweepRestrictedDir(dir = getRestrictedDir()) {
   }
   const cutoff = Date.now() - STALE_AFTER_MS;
   for (const entry of entries) {
-    const path71 = join33(dir, entry);
+    const path71 = join34(dir, entry);
     try {
       if (statSync3(path71).mtimeMs < cutoff) unlinkSync7(path71);
     } catch {
@@ -14327,12 +14454,12 @@ import { unlinkSync as unlinkSync9, writeFileSync as writeFileSync26 } from "fs"
 import chalk129 from "chalk";
 
 // src/commands/dbMigration/getMigrationPinPath.ts
-import { join as join34 } from "path";
+import { join as join35 } from "path";
 function getMigrationPinPath(pin) {
-  return join34(getRestrictedDir(), `db-migration-pin-${pin}.json`);
+  return join35(getRestrictedDir(), `db-migration-pin-${pin}.json`);
 }
 function getMigrationApprovalPath(migrationId) {
-  return join34(getRestrictedDir(), `db-migration-approval-${migrationId}.json`);
+  return join35(getRestrictedDir(), `db-migration-approval-${migrationId}.json`);
 }
 
 // src/commands/dbMigration/readMigrationPinState.ts
@@ -14470,10 +14597,10 @@ import { basename as basename9 } from "path";
 
 // src/commands/devlog/loadBlogSkipDays.ts
 import { homedir as homedir18 } from "os";
-import { join as join35 } from "path";
-var BLOG_REPO_ROOT = join35(homedir18(), "git/blog");
+import { join as join36 } from "path";
+var BLOG_REPO_ROOT = join36(homedir18(), "git/blog");
 function loadBlogSkipDays(repoName) {
-  const config = loadRawYaml(join35(BLOG_REPO_ROOT, "assist.yml"));
+  const config = loadRawYaml(join36(BLOG_REPO_ROOT, "assist.yml"));
   const devlog = config.devlog;
   const skip2 = devlog?.skip;
   return new Set(skip2?.[repoName]);
@@ -14485,13 +14612,13 @@ import chalk132 from "chalk";
 
 // src/shared/getRepoName.ts
 import { existsSync as existsSync36, readFileSync as readFileSync30 } from "fs";
-import { basename as basename8, join as join36 } from "path";
+import { basename as basename8, join as join37 } from "path";
 function getRepoName() {
   const config = loadConfig();
   if (config.devlog?.name) {
     return config.devlog.name;
   }
-  const packageJsonPath = join36(process.cwd(), "package.json");
+  const packageJsonPath = join37(process.cwd(), "package.json");
   if (existsSync36(packageJsonPath)) {
     try {
       const content = readFileSync30(packageJsonPath, "utf8");
@@ -14507,8 +14634,8 @@ function getRepoName() {
 
 // src/commands/devlog/loadDevlogEntries.ts
 import { readdirSync as readdirSync4, readFileSync as readFileSync31 } from "fs";
-import { join as join37 } from "path";
-var DEVLOG_DIR = join37(BLOG_REPO_ROOT, "src/content/devlog");
+import { join as join38 } from "path";
+var DEVLOG_DIR = join38(BLOG_REPO_ROOT, "src/content/devlog");
 function extractFrontmatter(content) {
   const fm = content.match(/^---\n([\s\S]*?)\n---/);
   return fm?.[1] ?? null;
@@ -14536,7 +14663,7 @@ function readDevlogFiles(callback) {
   try {
     const files = readdirSync4(DEVLOG_DIR).filter((f) => f.endsWith(".md"));
     for (const file of files) {
-      const content = readFileSync31(join37(DEVLOG_DIR, file), "utf8");
+      const content = readFileSync31(join38(DEVLOG_DIR, file), "utf8");
       const parsed = parseFrontmatter(content, file);
       if (parsed) callback(parsed);
     }
@@ -14924,11 +15051,11 @@ function repos(options2) {
 
 // src/commands/devlog/skip.ts
 import { writeFileSync as writeFileSync29 } from "fs";
-import { join as join38 } from "path";
+import { join as join39 } from "path";
 import chalk137 from "chalk";
 import { stringify as stringifyYaml3 } from "yaml";
 function getBlogConfigPath() {
-  return join38(BLOG_REPO_ROOT, "assist.yml");
+  return join39(BLOG_REPO_ROOT, "assist.yml");
 }
 function skip(date) {
   if (!/^\d{4}-\d{2}-\d{2}$/.test(date)) {
@@ -15009,7 +15136,7 @@ function registerDevlog(program2) {
 
 // src/commands/dotnet/checkBuildLocks.ts
 import { closeSync as closeSync3, openSync as openSync3, readdirSync as readdirSync5 } from "fs";
-import { join as join39 } from "path";
+import { join as join40 } from "path";
 import chalk139 from "chalk";
 
 // src/shared/findRepoRoot.ts
@@ -15037,7 +15164,7 @@ function isLockedDll(debugDir) {
   }
   for (const file of files) {
     if (!file.toLowerCase().endsWith(".dll")) continue;
-    const dllPath = join39(debugDir, file);
+    const dllPath = join40(debugDir, file);
     try {
       const fd = openSync3(dllPath, "r+");
       closeSync3(fd);
@@ -15055,13 +15182,13 @@ function findFirstLockedDll(dir) {
     return null;
   }
   if (entries.includes("bin")) {
-    const locked = isLockedDll(join39(dir, "bin", "Debug"));
+    const locked = isLockedDll(join40(dir, "bin", "Debug"));
     if (locked) return locked;
   }
   for (const entry of entries) {
     if (SKIP_DIRS.has(entry) || entry === "bin" || entry.startsWith("."))
       continue;
-    const found = findFirstLockedDll(join39(dir, entry));
+    const found = findFirstLockedDll(join40(dir, entry));
     if (found) return found;
   }
   return null;
@@ -15408,11 +15535,11 @@ import chalk145 from "chalk";
 
 // src/commands/dotnet/findSolution.ts
 import { readdirSync as readdirSync7 } from "fs";
-import { dirname as dirname22, join as join40 } from "path";
+import { dirname as dirname22, join as join41 } from "path";
 import chalk144 from "chalk";
 function findSlnInDir(dir) {
   try {
-    return readdirSync7(dir).filter((f) => f.endsWith(".sln")).map((f) => join40(dir, f));
+    return readdirSync7(dir).filter((f) => f.endsWith(".sln")).map((f) => join41(dir, f));
   } catch {
     return [];
   }
@@ -15484,7 +15611,7 @@ function parseInspectReport(json) {
 // src/commands/dotnet/runInspectCode.ts
 import { execSync as execSync37 } from "child_process";
 import { existsSync as existsSync40, readFileSync as readFileSync34, unlinkSync as unlinkSync10 } from "fs";
-import { tmpdir as tmpdir3 } from "os";
+import { tmpdir as tmpdir4 } from "os";
 import path35 from "path";
 import chalk146 from "chalk";
 function assertJbInstalled() {
@@ -15499,7 +15626,7 @@ function assertJbInstalled() {
   }
 }
 function runInspectCode(slnPath, include, swea) {
-  const reportPath = path35.join(tmpdir3(), `inspect-${Date.now()}.xml`);
+  const reportPath = path35.join(tmpdir4(), `inspect-${Date.now()}.xml`);
   const includeFlag = include ? ` --include="${include}"` : "";
   const sweaFlag = swea ? " --swea" : "";
   try {
@@ -15900,8 +16027,8 @@ function aggregateCommitters(authorLists) {
 // src/shared/runGhGraphql.ts
 import { spawnSync as spawnSync4 } from "child_process";
 import { unlinkSync as unlinkSync12, writeFileSync as writeFileSync30 } from "fs";
-import { tmpdir as tmpdir4 } from "os";
-import { join as join41 } from "path";
+import { tmpdir as tmpdir5 } from "os";
+import { join as join42 } from "path";
 function buildArgs2(queryFile, vars) {
   const args = ["api", "graphql", "-F", `query=@${queryFile}`];
   for (const [key, value] of Object.entries(vars)) {
@@ -15926,7 +16053,7 @@ function throwOnGraphqlErrors(stdout) {
   throw new Error(messages || "GraphQL request returned errors");
 }
 function runGhGraphql(mutation, vars) {
-  const queryFile = join41(tmpdir4(), `gh-query-${Date.now()}.graphql`);
+  const queryFile = join42(tmpdir5(), `gh-query-${Date.now()}.graphql`);
   writeFileSync30(queryFile, mutation);
   try {
     const result = spawnSync4("gh", buildArgs2(queryFile, vars), {
@@ -16119,18 +16246,18 @@ import {
   rmSync as rmSync3,
   statSync as statSync5
 } from "fs";
-import { basename as basename10, join as join44 } from "path";
+import { basename as basename10, join as join45 } from "path";
 
 // src/commands/handover/getHandoverPath.ts
-import { join as join42 } from "path";
+import { join as join43 } from "path";
 function getHandoverPath(cwd = process.cwd()) {
-  return join42(cwd, ".assist", "HANDOVER.md");
+  return join43(cwd, ".assist", "HANDOVER.md");
 }
 
 // src/commands/handover/getHandoversDir.ts
-import { join as join43 } from "path";
+import { join as join44 } from "path";
 function getHandoversDir(cwd = process.cwd()) {
-  return join43(cwd, ".assist", "handovers");
+  return join44(cwd, ".assist", "handovers");
 }
 
 // src/commands/handover/parseArchiveTimestamp.ts
@@ -16171,7 +16298,7 @@ function collectMarkdown(dir) {
   if (!existsSync42(dir)) return [];
   const out = [];
   for (const entry of readdirSync8(dir, { withFileTypes: true })) {
-    const full = join44(dir, entry.name);
+    const full = join45(dir, entry.name);
     if (entry.isDirectory()) out.push(...collectMarkdown(full));
     else if (entry.isFile() && entry.name.endsWith(".md")) out.push(full);
   }
@@ -16619,7 +16746,7 @@ import chalk156 from "chalk";
 
 // src/commands/mermaid/exportFile.ts
 import { readFileSync as readFileSync36, writeFileSync as writeFileSync31 } from "fs";
-import { basename as basename11, extname, resolve as resolve11 } from "path";
+import { basename as basename11, extname as extname2, resolve as resolve11 } from "path";
 import chalk155 from "chalk";
 
 // src/commands/mermaid/renderBlock.ts
@@ -16646,7 +16773,7 @@ async function renderBlock(krokiUrl, source) {
 async function exportFile(file, outDir, krokiUrl, onlyIndex) {
   const content = readFileSync36(file, "utf8");
   const blocks = extractMermaidBlocks(content);
-  const stem = basename11(file, extname(file));
+  const stem = basename11(file, extname2(file));
   if (onlyIndex !== void 0) {
     if (onlyIndex < 1 || onlyIndex > blocks.length) {
       console.error(
@@ -16806,17 +16933,17 @@ function createNetcapHandler(options2) {
 }
 
 // src/commands/netcap/prepareExtensionForLoad.ts
-import { cp, readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
+import { cp, readFile as readFile2, writeFile as writeFile3 } from "fs/promises";
 import { networkInterfaces } from "os";
-import { join as join46 } from "path";
+import { join as join47 } from "path";
 import chalk157 from "chalk";
 
 // src/commands/netcap/netcapExtensionDir.ts
-import { dirname as dirname23, join as join45 } from "path";
+import { dirname as dirname23, join as join46 } from "path";
 import { fileURLToPath as fileURLToPath6 } from "url";
 var moduleDir = dirname23(fileURLToPath6(import.meta.url));
 function netcapExtensionDir() {
-  return join45(moduleDir, "commands", "netcap", "netcap-extension");
+  return join46(moduleDir, "commands", "netcap", "netcap-extension");
 }
 
 // src/commands/netcap/prepareExtensionForLoad.ts
@@ -16831,9 +16958,9 @@ function lanIPv4() {
   return void 0;
 }
 async function configureBackground(dir, host, port, filter) {
-  const file = join46(dir, "background.js");
+  const file = join47(dir, "background.js");
   const source = await readFile2(file, "utf8");
-  await writeFile2(
+  await writeFile3(
     file,
     source.replace(
       /const RECEIVER = "[^"]*";/,
@@ -16871,20 +16998,20 @@ async function prepareExtensionForLoad(port, filter = "") {
 }
 
 // src/commands/netcap/resolveNetcapOutPath.ts
-import { isAbsolute, join as join48, resolve as resolve13 } from "path";
+import { isAbsolute, join as join49, resolve as resolve13 } from "path";
 
 // src/commands/netcap/defaultCapturePath.ts
 import { homedir as homedir19 } from "os";
-import { join as join47 } from "path";
+import { join as join48 } from "path";
 function defaultCapturePath() {
-  return join47(homedir19(), ".assist", "netcap", "capture.jsonl");
+  return join48(homedir19(), ".assist", "netcap", "capture.jsonl");
 }
 
 // src/commands/netcap/resolveNetcapOutPath.ts
 function resolveNetcapOutPath(out) {
   if (!out) return defaultCapturePath();
   const dir = isAbsolute(out) ? out : resolve13(process.cwd(), out);
-  return join48(dir, "capture.jsonl");
+  return join49(dir, "capture.jsonl");
 }
 
 // src/commands/netcap/netcap.ts
@@ -16931,7 +17058,7 @@ netcap stopped \u2014 captured ${count7} ${count7 === 1 ? "entry" : "entries"} t
 
 // src/commands/netcap/netcapExtract.ts
 import { writeFileSync as writeFileSync32 } from "fs";
-import { join as join49 } from "path";
+import { join as join50 } from "path";
 import chalk159 from "chalk";
 
 // src/commands/netcap/extractPostsFromCapture.ts
@@ -17376,7 +17503,7 @@ function extractPostsFromCapture(captureFile) {
 function netcapExtract(file) {
   const captureFile = file ?? defaultCapturePath();
   const posts = extractPostsFromCapture(captureFile);
-  const outFile = join49(captureFile, "..", "posts.json");
+  const outFile = join50(captureFile, "..", "posts.json");
   writeFileSync32(outFile, `${JSON.stringify(posts, null, 2)}
 `);
   console.log(
@@ -17866,15 +17993,15 @@ import { execSync as execSync43 } from "child_process";
 // src/commands/prs/resolveCommentWithReply.ts
 import { execSync as execSync42 } from "child_process";
 import { unlinkSync as unlinkSync14, writeFileSync as writeFileSync33 } from "fs";
-import { tmpdir as tmpdir5 } from "os";
-import { join as join51 } from "path";
+import { tmpdir as tmpdir6 } from "os";
+import { join as join52 } from "path";
 
 // src/commands/prs/loadCommentsCache.ts
 import { existsSync as existsSync43, readFileSync as readFileSync38, unlinkSync as unlinkSync13 } from "fs";
-import { join as join50 } from "path";
+import { join as join51 } from "path";
 import { parse as parse2 } from "yaml";
 function getCachePath(prNumber) {
-  return join50(process.cwd(), ".assist", `pr-${prNumber}-comments.yaml`);
+  return join51(process.cwd(), ".assist", `pr-${prNumber}-comments.yaml`);
 }
 function loadCommentsCache(prNumber) {
   const cachePath = getCachePath(prNumber);
@@ -17904,7 +18031,7 @@ function replyToComment(org, repo, prNumber, commentId, message) {
 // src/commands/prs/resolveCommentWithReply.ts
 function resolveThread(threadId) {
   const mutation = `mutation($threadId: ID!) { resolveReviewThread(input: {threadId: $threadId}) { thread { isResolved } } }`;
-  const queryFile = join51(tmpdir5(), `gh-mutation-${Date.now()}.graphql`);
+  const queryFile = join52(tmpdir6(), `gh-mutation-${Date.now()}.graphql`);
   writeFileSync33(queryFile, mutation);
   try {
     execSync42(
@@ -17987,17 +18114,17 @@ function fixed(commentId, sha) {
 
 // src/commands/prs/listComments/index.ts
 import { existsSync as existsSync44, mkdirSync as mkdirSync17, writeFileSync as writeFileSync35 } from "fs";
-import { join as join53 } from "path";
+import { join as join54 } from "path";
 import { stringify } from "yaml";
 
 // src/commands/prs/fetchThreadIds.ts
 import { execSync as execSync44 } from "child_process";
 import { unlinkSync as unlinkSync15, writeFileSync as writeFileSync34 } from "fs";
-import { tmpdir as tmpdir6 } from "os";
-import { join as join52 } from "path";
+import { tmpdir as tmpdir7 } from "os";
+import { join as join53 } 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 } } } } } } }`;
 function fetchThreadIds(org, repo, prNumber) {
-  const queryFile = join52(tmpdir6(), `gh-query-${Date.now()}.graphql`);
+  const queryFile = join53(tmpdir7(), `gh-query-${Date.now()}.graphql`);
   writeFileSync34(queryFile, THREAD_QUERY);
   try {
     const result = execSync44(
@@ -18111,7 +18238,7 @@ function printComments2(result) {
 
 // src/commands/prs/listComments/index.ts
 function writeCommentsCache(prNumber, comments3) {
-  const assistDir = join53(process.cwd(), ".assist");
+  const assistDir = join54(process.cwd(), ".assist");
   if (!existsSync44(assistDir)) {
     mkdirSync17(assistDir, { recursive: true });
   }
@@ -18120,7 +18247,7 @@ function writeCommentsCache(prNumber, comments3) {
     fetchedAt: (/* @__PURE__ */ new Date()).toISOString(),
     comments: comments3
   };
-  const cachePath = join53(assistDir, `pr-${prNumber}-comments.yaml`);
+  const cachePath = join54(assistDir, `pr-${prNumber}-comments.yaml`);
   writeFileSync35(cachePath, stringify(cacheData));
 }
 function handleKnownErrors(error) {
@@ -18153,7 +18280,7 @@ async function listComments() {
     ];
     updateCache(prNumber, allComments);
     const hasLineComments = allComments.some((c) => c.type === "line");
-    const cachePath = hasLineComments ? join53(process.cwd(), ".assist", `pr-${prNumber}-comments.yaml`) : null;
+    const cachePath = hasLineComments ? join54(process.cwd(), ".assist", `pr-${prNumber}-comments.yaml`) : null;
     return { comments: allComments, cachePath };
   } catch (error) {
     const handled = handleKnownErrors(error);
@@ -18404,6 +18531,39 @@ async function placePr(prNumber, title, body, options2) {
 // src/commands/prs/previewAndPlace.ts
 import { randomUUID as randomUUID4 } from "crypto";
 
+// src/commands/prs/appendScreenshots.ts
+function appendScreenshots(body, screenshots) {
+  if (screenshots.length === 0) return body;
+  return `${body}
+
+## Screenshots
+
+${screenshots.join("\n\n")}`;
+}
+
+// src/commands/prs/reportPrRejection.ts
+function reportPrRejection(decision) {
+  console.error(
+    `PR preview rejected${decision.reason ? `: ${decision.reason}` : "."}`
+  );
+  const comments3 = decision.comments ?? [];
+  if (comments3.length > 0) {
+    console.error(
+      `
+The reviewer left ${comments3.length} comment${comments3.length === 1 ? "" : "s"} on the preview. Address each one, then re-run this command:
+`
+    );
+    for (const [i, c] of comments3.entries()) {
+      const quoted = c.quote.split("\n").map((line) => `  > ${line}`).join("\n");
+      console.error(`${i + 1}. On:
+${quoted}
+   Comment: ${c.note}
+`);
+    }
+  }
+  process.exit(1);
+}
+
 // src/commands/prs/parseIncoming.ts
 function parseIncoming(line, requestId) {
   try {
@@ -18417,7 +18577,8 @@ function parseIncoming(line, requestId) {
       decision: {
         decision: msg.decision,
         reason: msg.reason,
-        comments: Array.isArray(msg.comments) ? msg.comments : void 0
+        comments: Array.isArray(msg.comments) ? msg.comments : void 0,
+        screenshots: Array.isArray(msg.screenshots) ? msg.screenshots : void 0
       }
     };
   } catch {
@@ -18472,28 +18633,9 @@ async function previewAndPlace(args) {
     );
     process.exit(1);
   }
-  if (decision.decision === "reject") {
-    console.error(
-      `PR preview rejected${decision.reason ? `: ${decision.reason}` : "."}`
-    );
-    const comments3 = decision.comments ?? [];
-    if (comments3.length > 0) {
-      console.error(
-        `
-The reviewer left ${comments3.length} comment${comments3.length === 1 ? "" : "s"} on the preview. Address each one, then re-run this command:
-`
-      );
-      for (const [i, c] of comments3.entries()) {
-        const quoted = c.quote.split("\n").map((line) => `  > ${line}`).join("\n");
-        console.error(`${i + 1}. On:
-${quoted}
-   Comment: ${c.note}
-`);
-      }
-    }
-    process.exit(1);
-  }
-  await placePr(args.prNumber, args.title, args.body, args.options);
+  if (decision.decision === "reject") reportPrRejection(decision);
+  const body = appendScreenshots(args.body, decision.screenshots ?? []);
+  await placePr(args.prNumber, args.title, body, args.options);
 }
 
 // src/commands/prs/raise.ts
@@ -18706,7 +18848,10 @@ on rejection it exits non-zero with the reason. The reviewer may also attach
 inline comments to specific spans of the preview; on rejection these are printed
 as numbered quoted-span + note pairs on stderr. Address every comment (and the
 reason), then run the command again to re-preview the revised PR. Repeat until it
-is approved. Just compose the sections and run the command.`;
+is approved. The reviewer may also drop or paste screenshots into the pane; on
+approval these are appended to the PR body under a ## Screenshots section
+automatically (they are discarded on rejection), so you never author that section
+yourself. Just compose the sections and run the command.`;
 function raiseHelpText(promptJira) {
   const prompt = promptJira ?? loadConfig().prs?.promptJira ?? false;
   const confirm = process.env.ASSIST_SESSION === "1" ? WEB_CONFIRM : TERMINAL_CONFIRM;
@@ -21014,9 +21159,9 @@ ${annotateDiffWithLineNumbers(context.diff.trimEnd())}
 
 // src/commands/review/buildReviewPaths.ts
 import { homedir as homedir20 } from "os";
-import { basename as basename12, join as join54 } from "path";
+import { basename as basename12, join as join55 } from "path";
 function buildReviewPaths(repoRoot, key) {
-  const reviewDir = join54(
+  const reviewDir = join55(
     homedir20(),
     ".assist",
     "reviews",
@@ -21025,10 +21170,10 @@ function buildReviewPaths(repoRoot, key) {
   );
   return {
     reviewDir,
-    requestPath: join54(reviewDir, "request.md"),
-    claudePath: join54(reviewDir, "claude.md"),
-    codexPath: join54(reviewDir, "codex.md"),
-    synthesisPath: join54(reviewDir, "synthesis.md")
+    requestPath: join55(reviewDir, "request.md"),
+    claudePath: join55(reviewDir, "claude.md"),
+    codexPath: join55(reviewDir, "codex.md"),
+    synthesisPath: join55(reviewDir, "synthesis.md")
   };
 }
 
@@ -23354,13 +23499,13 @@ async function configure() {
 
 // src/commands/transcript/list.ts
 import { existsSync as existsSync48, readdirSync as readdirSync10, statSync as statSync7 } from "fs";
-import { join as join55 } from "path";
+import { join as join56 } from "path";
 function list4() {
   const { vttDir } = getTranscriptConfig();
   if (!existsSync48(vttDir)) return;
   for (const entry of readdirSync10(vttDir)) {
     if (!entry.endsWith(".vtt")) continue;
-    if (statSync7(join55(vttDir, entry)).isDirectory()) continue;
+    if (statSync7(join56(vttDir, entry)).isDirectory()) continue;
     console.log(entry);
   }
 }
@@ -23373,7 +23518,7 @@ import {
   renameSync as renameSync2,
   writeFileSync as writeFileSync38
 } from "fs";
-import { basename as basename13, join as join56 } from "path";
+import { basename as basename13, join as join57 } from "path";
 
 // src/commands/transcript/cleanText.ts
 function cleanText(text17) {
@@ -23586,9 +23731,9 @@ function convertVttToMarkdown(inputPath) {
   return formatChatLog(messages);
 }
 function archiveRawVtt(vttDir, sourcePath, filename) {
-  const processedDir = join56(vttDir, "processed");
+  const processedDir = join57(vttDir, "processed");
   mkdirSync19(processedDir, { recursive: true });
-  renameSync2(sourcePath, join56(processedDir, filename));
+  renameSync2(sourcePath, join57(processedDir, filename));
 }
 function move(file, options2) {
   const { date, client } = options2;
@@ -23598,19 +23743,19 @@ function move(file, options2) {
   }
   const { vttDir, transcriptsDir, summaryDir } = getTranscriptConfig();
   const filename = basename13(file);
-  const sourcePath = join56(vttDir, filename);
+  const sourcePath = join57(vttDir, filename);
   if (!existsSync49(sourcePath)) {
     console.error(`Error: VTT file not found: ${sourcePath}`);
     process.exit(1);
   }
   const base = basename13(filename, ".vtt").replace(/ Transcription$/, "");
   const outputName = `${date} ${base}.md`;
-  const formattedDir = join56(transcriptsDir, client);
+  const formattedDir = join57(transcriptsDir, client);
   mkdirSync19(formattedDir, { recursive: true });
-  const formattedPath = join56(formattedDir, outputName);
+  const formattedPath = join57(formattedDir, outputName);
   writeFileSync38(formattedPath, convertVttToMarkdown(sourcePath), "utf8");
   archiveRawVtt(vttDir, sourcePath, filename);
-  const summaryPath = join56(summaryDir, client, outputName);
+  const summaryPath = join57(summaryDir, client, outputName);
   console.log(`Formatted transcript: ${formattedPath}`);
   console.log(`Summary target:       ${summaryPath}`);
 }
@@ -23730,38 +23875,38 @@ function registerVerify(program2) {
 
 // src/commands/voice/devices.ts
 import { spawnSync as spawnSync6 } from "child_process";
-import { join as join58 } from "path";
+import { join as join59 } from "path";
 
 // src/commands/voice/shared.ts
 import { homedir as homedir21 } from "os";
-import { dirname as dirname26, join as join57 } from "path";
+import { dirname as dirname26, join as join58 } from "path";
 import { fileURLToPath as fileURLToPath7 } from "url";
 var __dirname5 = dirname26(fileURLToPath7(import.meta.url));
-var VOICE_DIR = join57(homedir21(), ".assist", "voice");
+var VOICE_DIR = join58(homedir21(), ".assist", "voice");
 var voicePaths = {
   dir: VOICE_DIR,
-  pid: join57(VOICE_DIR, "voice.pid"),
-  log: join57(VOICE_DIR, "voice.log"),
-  venv: join57(VOICE_DIR, ".venv"),
-  lock: join57(VOICE_DIR, "voice.lock")
+  pid: join58(VOICE_DIR, "voice.pid"),
+  log: join58(VOICE_DIR, "voice.log"),
+  venv: join58(VOICE_DIR, ".venv"),
+  lock: join58(VOICE_DIR, "voice.lock")
 };
 function getPythonDir() {
-  return join57(__dirname5, "commands", "voice", "python");
+  return join58(__dirname5, "commands", "voice", "python");
 }
 function getVenvPython() {
-  return process.platform === "win32" ? join57(voicePaths.venv, "Scripts", "python.exe") : join57(voicePaths.venv, "bin", "python");
+  return process.platform === "win32" ? join58(voicePaths.venv, "Scripts", "python.exe") : join58(voicePaths.venv, "bin", "python");
 }
 function getLockDir() {
   const config = loadConfig();
   return config.voice?.lockDir ?? VOICE_DIR;
 }
 function getLockFile() {
-  return join57(getLockDir(), "voice.lock");
+  return join58(getLockDir(), "voice.lock");
 }
 
 // src/commands/voice/devices.ts
 function devices() {
-  const script = join58(getPythonDir(), "list_devices.py");
+  const script = join59(getPythonDir(), "list_devices.py");
   spawnSync6(getVenvPython(), [script], { stdio: "inherit" });
 }
 
@@ -23796,12 +23941,12 @@ function logs(options2) {
 // src/commands/voice/setup.ts
 import { spawnSync as spawnSync7 } from "child_process";
 import { mkdirSync as mkdirSync21 } from "fs";
-import { join as join60 } from "path";
+import { join as join61 } from "path";
 
 // src/commands/voice/checkLockFile.ts
 import { execSync as execSync56 } from "child_process";
 import { existsSync as existsSync51, mkdirSync as mkdirSync20, readFileSync as readFileSync43, writeFileSync as writeFileSync39 } from "fs";
-import { join as join59 } from "path";
+import { join as join60 } from "path";
 function isProcessAlive2(pid) {
   try {
     process.kill(pid, 0);
@@ -23838,7 +23983,7 @@ function bootstrapVenv() {
 }
 function writeLockFile(pid) {
   const lockFile = getLockFile();
-  mkdirSync20(join59(lockFile, ".."), { recursive: true });
+  mkdirSync20(join60(lockFile, ".."), { recursive: true });
   writeFileSync39(
     lockFile,
     JSON.stringify({
@@ -23854,7 +23999,7 @@ function setup() {
   mkdirSync21(voicePaths.dir, { recursive: true });
   bootstrapVenv();
   console.log("\nDownloading models...\n");
-  const script = join60(getPythonDir(), "setup_models.py");
+  const script = join61(getPythonDir(), "setup_models.py");
   const result = spawnSync7(getVenvPython(), [script], {
     stdio: "inherit",
     env: { ...process.env, VOICE_LOG_FILE: voicePaths.log }
@@ -23868,7 +24013,7 @@ function setup() {
 // src/commands/voice/start.ts
 import { spawn as spawn7 } from "child_process";
 import { mkdirSync as mkdirSync22, writeFileSync as writeFileSync40 } from "fs";
-import { join as join61 } from "path";
+import { join as join62 } from "path";
 
 // src/commands/voice/buildDaemonEnv.ts
 function buildDaemonEnv(options2) {
@@ -23906,7 +24051,7 @@ function start2(options2) {
   bootstrapVenv();
   const debug = options2.debug || options2.foreground || process.platform === "win32";
   const env = buildDaemonEnv({ debug });
-  const script = join61(getPythonDir(), "voice_daemon.py");
+  const script = join62(getPythonDir(), "voice_daemon.py");
   const python = getVenvPython();
   if (options2.foreground) {
     spawnForeground(python, script, env);
@@ -24197,7 +24342,7 @@ async function auth() {
 // src/commands/roam/postRoamActivity.ts
 import { execFileSync as execFileSync9 } from "child_process";
 import { readdirSync as readdirSync11, readFileSync as readFileSync46, statSync as statSync8 } from "fs";
-import { join as join62 } from "path";
+import { join as join63 } from "path";
 function findPortFile(roamDir) {
   let entries;
   try {
@@ -24206,7 +24351,7 @@ function findPortFile(roamDir) {
     return void 0;
   }
   const candidates = entries.filter((name) => /^roam-local-api(-[^.]+)?\.port$/.test(name)).map((name) => {
-    const path71 = join62(roamDir, name);
+    const path71 = join63(roamDir, name);
     try {
       return { path: path71, mtimeMs: statSync8(path71).mtimeMs };
     } catch {
@@ -24218,7 +24363,7 @@ function findPortFile(roamDir) {
 function postRoamActivity(app, event) {
   const appData = process.env.APPDATA;
   if (!appData) return;
-  const portFile = findPortFile(join62(appData, "Roam"));
+  const portFile = findPortFile(join63(appData, "Roam"));
   if (!portFile) return;
   let port;
   try {
@@ -24439,13 +24584,13 @@ function runPreCommands(pre, cwd) {
 // src/commands/run/spawnRunCommand.ts
 import { execFileSync as execFileSync10, spawn as spawn8 } from "child_process";
 import { existsSync as existsSync54 } from "fs";
-import { dirname as dirname27, join as join63, resolve as resolve14 } from "path";
+import { dirname as dirname27, join as join64, resolve as resolve14 } from "path";
 function resolveCommand2(command) {
   if (process.platform !== "win32" || command !== "bash") return command;
   try {
     const gitPath = execFileSync10("where", ["git"], { encoding: "utf8" }).trim().split("\r\n")[0];
     const gitRoot = resolve14(dirname27(gitPath), "..");
-    const gitBash = join63(gitRoot, "bin", "bash.exe");
+    const gitBash = join64(gitRoot, "bin", "bash.exe");
     if (existsSync54(gitBash)) return gitBash;
   } catch {
   }
@@ -24534,7 +24679,7 @@ async function run3(name, args) {
 
 // src/commands/run/add.ts
 import { mkdirSync as mkdirSync23, writeFileSync as writeFileSync41 } from "fs";
-import { join as join64 } from "path";
+import { join as join65 } from "path";
 
 // src/commands/run/extractOption.ts
 function extractOption(args, flag) {
@@ -24595,7 +24740,7 @@ function saveNewRunConfig(name, command, args, cwd) {
   saveConfig(config);
 }
 function createCommandFile(name) {
-  const dir = join64(".claude", "commands");
+  const dir = join65(".claude", "commands");
   mkdirSync23(dir, { recursive: true });
   const content = `---
 description: Run ${name}
@@ -24603,7 +24748,7 @@ description: Run ${name}
 
 Run \`assist run ${name} $ARGUMENTS 2>&1\`.
 `;
-  const filePath = join64(dir, `${name}.md`);
+  const filePath = join65(dir, `${name}.md`);
   writeFileSync41(filePath, content);
   console.log(`Created command file: ${filePath}`);
 }
@@ -24660,7 +24805,7 @@ function link2() {
 
 // src/commands/run/remove.ts
 import { existsSync as existsSync55, unlinkSync as unlinkSync20 } from "fs";
-import { join as join65 } from "path";
+import { join as join66 } from "path";
 function findRemoveIndex() {
   const idx = process.argv.indexOf("remove");
   if (idx === -1 || idx + 1 >= process.argv.length) return -1;
@@ -24675,7 +24820,7 @@ function parseRemoveName() {
   return process.argv[idx + 1];
 }
 function deleteCommandFile(name) {
-  const filePath = join65(".claude", "commands", `${name}.md`);
+  const filePath = join66(".claude", "commands", `${name}.md`);
   if (existsSync55(filePath)) {
     unlinkSync20(filePath);
     console.log(`Deleted command file: ${filePath}`);
@@ -24731,8 +24876,8 @@ function registerRun(program2) {
 // src/commands/screenshot/index.ts
 import { execSync as execSync58 } from "child_process";
 import { existsSync as existsSync56, mkdirSync as mkdirSync24, unlinkSync as unlinkSync21, writeFileSync as writeFileSync42 } from "fs";
-import { tmpdir as tmpdir7 } from "os";
-import { join as join66, resolve as resolve16 } from "path";
+import { tmpdir as tmpdir8 } from "os";
+import { join as join67, resolve as resolve16 } from "path";
 import chalk203 from "chalk";
 
 // src/commands/screenshot/captureWindowPs1.ts
@@ -24869,7 +25014,7 @@ function buildOutputPath(outputDir, processName) {
   return resolve16(outputDir, `${processName}-${timestamp6}.png`);
 }
 function runPowerShellScript(processName, outputPath) {
-  const scriptPath = join66(tmpdir7(), `assist-screenshot-${Date.now()}.ps1`);
+  const scriptPath = join67(tmpdir8(), `assist-screenshot-${Date.now()}.ps1`);
   writeFileSync42(scriptPath, captureWindowPs1, "utf8");
   try {
     execSync58(
@@ -25673,8 +25818,9 @@ function decidePrPreview(sessions, waiters, notify2, d) {
     return;
   }
   const commentCount = Array.isArray(d.comments) ? d.comments.length : 0;
+  const screenshotCount = Array.isArray(d.screenshots) ? d.screenshots.length : 0;
   daemonLog(
-    `pr-decision received: id=${id} requestId=${requestId} decision=${d.decision} comments=${commentCount}`
+    `pr-decision received: id=${id} requestId=${requestId} decision=${d.decision} comments=${commentCount} screenshots=${screenshotCount}`
   );
   const waiter = waiters.get(id);
   if (waiter)
@@ -25683,7 +25829,8 @@ function decidePrPreview(sessions, waiters, notify2, d) {
       requestId,
       decision: d.decision,
       reason: d.reason,
-      comments: d.comments
+      comments: d.comments,
+      screenshots: d.screenshots
     });
   waiters.delete(id);
   session.pendingPrPreview = void 0;
@@ -28469,9 +28616,9 @@ function buildLimitsSegment(rateLimits) {
 
 // src/commands/readGitBranch.ts
 import { readFileSync as readFileSync52, statSync as statSync11 } from "fs";
-import { isAbsolute as isAbsolute2, join as join69, resolve as resolve17 } from "path";
+import { isAbsolute as isAbsolute2, join as join70, resolve as resolve17 } from "path";
 function resolveGitDir(cwd) {
-  const dotGit = join69(cwd, ".git");
+  const dotGit = join70(cwd, ".git");
   let stat2;
   try {
     stat2 = statSync11(dotGit);
@@ -28501,7 +28648,7 @@ function readGitBranch(cwd) {
   }
   let head;
   try {
-    head = readFileSync52(join69(gitDir, "HEAD"), "utf8");
+    head = readFileSync52(join70(gitDir, "HEAD"), "utf8");
   } catch {
     return null;
   }