@reviewflow/sdk 6.25.0 → 6.27.0

package/build/index-browser.es.js

@@ -1,3 +1,77 @@
+const sameRepo = (left, right) => left !== null && left.toLowerCase() === right.toLowerCase();
+const pullRequestOfBranch = (pullRequests, ownerRepo, branch) => pullRequests.find(
+  (pullRequest) => pullRequest.headRefName === branch && sameRepo(pullRequest.headOwnerRepo, ownerRepo)
+) ?? null;
+const pullRequestsWithoutBranch = (pullRequests, ownerRepo, branches) => {
+  const names = new Set(branches.map(({ name }) => name));
+  return pullRequests.filter(
+    (pullRequest) => !names.has(pullRequest.headRefName) || !sameRepo(pullRequest.headOwnerRepo, ownerRepo)
+  );
+};
+
+const upstreamGone = (upstream) => `${upstream} no longer exists on the remote`;
+const pullRefusal = (status) => {
+  if (status.branch === null) return "a detached HEAD has nothing to pull into";
+  if (status.upstream === null) {
+    return `${status.branch} tracks no remote branch`;
+  }
+  if (status.behind === null) return upstreamGone(status.upstream);
+  if (status.behind === 0) {
+    return `${status.branch} is not behind ${status.upstream}`;
+  }
+  return null;
+};
+const pushRefusal = (status, hasOrigin) => {
+  if (status.branch === null) return "a detached HEAD has no branch to push";
+  if (status.upstream === null) {
+    return hasOrigin ? null : "this repository has no origin remote";
+  }
+  if (status.ahead === null) return upstreamGone(status.upstream);
+  if (status.ahead === 0) {
+    return `${status.branch} has nothing to push to ${status.upstream}`;
+  }
+  return null;
+};
+
+const fileCount = (count, kind) => count === 0 ? null : `${String(count)} ${kind} file${count === 1 ? "" : "s"}`;
+const mainWorktreeRefusal = "This is the main checkout, which holds the repository: it is never removed.";
+const dirtyRefusal = ({
+  modified,
+  untracked
+}) => {
+  const parts = [
+    fileCount(modified, "modified"),
+    fileCount(untracked, "untracked")
+  ].filter((part) => part !== null);
+  if (parts.length === 0) return null;
+  return `${parts.join(" and ")}: git would refuse to remove this worktree. Commit or discard them first.`;
+};
+const unpushedRefusal = (count) => {
+  if (count === 0) return null;
+  const subject = count === 1 ? "1 commit exists" : `${String(count)} commits exist`;
+  return `${subject} only in this clone, on no remote branch and in no pull request. Push them first.`;
+};
+const lockRefusal = (lock) => {
+  if (lock === null) return null;
+  const reason = lock === "" ? "" : ` (${lock})`;
+  return `git holds this worktree locked${reason}, usually by a Claude Code process still running in it. Exit it first.`;
+};
+const processesRefusal = (count) => {
+  if (count === null || count === 0) return null;
+  const subject = count === 1 ? "1 process runs" : `${String(count)} processes run`;
+  return `${subject} inside this worktree (a shell, an editor or an agent): removing it would pull the directory out from under them. Exit them first.`;
+};
+const worktreeRemovalRefusals = (status) => {
+  if (status.main) return [mainWorktreeRefusal];
+  return [
+    dirtyRefusal(status),
+    unpushedRefusal(status.unpushedCommits),
+    lockRefusal(status.lock),
+    processesRefusal(status.processesInside)
+  ].filter((refusal) => refusal !== null);
+};
+const worktreeRemovalRefusal = (status) => worktreeRemovalRefusals(status)[0] ?? null;
+
 const cEscapes = {
   a: 7,
   b: 8,
@@ -196,6 +270,7 @@ const diffFontOptions = [
 ];
 
 const isDiffWhitespace = (value) => value === "hide" || value === "show";
+const isBranchDiffScope = (value) => value === "committed" || value === "uncommitted";
 
 const fenceOpen = /^( {0,3})(`{3,}(?!`)|~{3,}(?!~))(.*)$/;
 const withoutIndent = (line, indent) => {
@@ -669,7 +744,7 @@ const pullRequestReactionContents = [
 ];
 const isPullRequestReactionContent = (value) => pullRequestReactionContents.includes(value);
 
-const isStringArray = (value) => Array.isArray(value) && value.every((item) => typeof item === "string");
+const isStringArray$1 = (value) => Array.isArray(value) && value.every((item) => typeof item === "string");
 const isNonEmptyString = (value) => typeof value === "string" && value.trim() !== "";
 const isPositiveInteger = (value) => typeof value === "number" && Number.isInteger(value) && value > 0;
 const isSha = (value) => typeof value === "string" && /^[\da-f]{40}$/i.test(value);
@@ -794,13 +869,13 @@ const parsePullRequestEdit = (value) => {
       return { kind: "title", title: edit.title.trim() };
     }
     case "labels": {
-      if (!isStringArray(edit.add) || !isStringArray(edit.remove)) {
+      if (!isStringArray$1(edit.add) || !isStringArray$1(edit.remove)) {
         return "labels take add and remove, arrays of names";
       }
       return { kind: "labels", add: edit.add, remove: edit.remove };
     }
     case "reviewers": {
-      if (!isStringArray(edit.add) || !isStringArray(edit.remove) || !isStringArray(edit.addTeams) || !isStringArray(edit.removeTeams)) {
+      if (!isStringArray$1(edit.add) || !isStringArray$1(edit.remove) || !isStringArray$1(edit.addTeams) || !isStringArray$1(edit.removeTeams)) {
         return "reviewers take add, remove, addTeams and removeTeams, arrays of logins and team slugs";
       }
       return {
@@ -816,7 +891,7 @@ const parsePullRequestEdit = (value) => {
       return { kind: "draft", draft: edit.draft };
     }
     case "assignees": {
-      if (!isStringArray(edit.add) || !isStringArray(edit.remove)) {
+      if (!isStringArray$1(edit.add) || !isStringArray$1(edit.remove)) {
         return "assignees take add and remove, arrays of logins";
       }
       return { kind: "assignees", add: edit.add, remove: edit.remove };
@@ -1376,6 +1451,91 @@ const diffLines = ({
   ];
 };
 
+const openPullRequestsLimit = 100;
+const openPullRequestsQuery = `query OpenPullRequests($owner: String!, $name: String!, $first: Int!) {
+  repository(owner: $owner, name: $name) {
+    pullRequests(states: OPEN, first: $first, orderBy: { field: UPDATED_AT, direction: DESC }) {
+      totalCount
+      nodes {
+        number
+        title
+        isDraft
+        updatedAt
+        headRefName
+        headRepository { nameWithOwner }
+        author { login }
+      }
+    }
+  }
+}`;
+const parseOpenPullRequests = ({
+  data,
+  errors
+}) => {
+  const connection = data?.repository?.pullRequests ?? null;
+  if (connection === null) {
+    throw new Error(errors.length > 0 ? errors.join("; ") : "not found");
+  }
+  const pullRequests = (connection.nodes ?? []).filter((node) => node !== null).map((node) => ({
+    number: node.number,
+    title: node.title,
+    isDraft: node.isDraft,
+    headRefName: node.headRefName,
+    headOwnerRepo: node.headRepository?.nameWithOwner ?? null,
+    author: node.author?.login ?? null,
+    updatedAt: node.updatedAt
+  }));
+  return { pullRequests, totalCount: connection.totalCount };
+};
+const fetchOpenPullRequests = async (transport, ownerRepo) => {
+  const split = splitOwnerRepo(ownerRepo);
+  if (split === null) throw new Error(`${ownerRepo} is not owner/repo`);
+  return parseOpenPullRequests(
+    await transport.graphql(openPullRequestsQuery, {
+      owner: split.owner,
+      name: split.name,
+      first: openPullRequestsLimit
+    })
+  );
+};
+const branchPullRequestsQuery = `query BranchPullRequests($owner: String!, $name: String!, $branch: String!) {
+  repository(owner: $owner, name: $name) {
+    pullRequests(headRefName: $branch, first: 20, orderBy: { field: UPDATED_AT, direction: DESC }) {
+      nodes {
+        number
+        state
+        headRefOid
+        headRepository { nameWithOwner }
+      }
+    }
+  }
+}`;
+const parseBranchPullRequestHeads = ({ data, errors }, ownerRepo) => {
+  const connection = data?.repository?.pullRequests ?? null;
+  if (connection === null) {
+    throw new Error(errors.length > 0 ? errors.join("; ") : "not found");
+  }
+  return (connection.nodes ?? []).filter((node) => node !== null).filter(
+    (node) => node.headRepository?.nameWithOwner.toLowerCase() === ownerRepo.toLowerCase()
+  ).map(({ number, state, headRefOid }) => ({
+    number,
+    state,
+    sha: headRefOid
+  }));
+};
+const fetchBranchPullRequestHeads = async (transport, ownerRepo, branch) => {
+  const split = splitOwnerRepo(ownerRepo);
+  if (split === null) throw new Error(`${ownerRepo} is not owner/repo`);
+  return parseBranchPullRequestHeads(
+    await transport.graphql(branchPullRequestsQuery, {
+      owner: split.owner,
+      name: split.name,
+      branch
+    }),
+    ownerRepo
+  );
+};
+
 const imgTag = /<img\b[^>]*>/gi;
 const decodeAttribute = (value) => value.replaceAll("&quot;", '"').replaceAll("&#39;", "'").replaceAll("&lt;", "<").replaceAll("&gt;", ">").replaceAll("&amp;", "&");
 const attribute = (tag, name) => {
@@ -3488,21 +3648,49 @@ const createReviewflowFollower = ({
   };
 };
 
-const defaultRepoPath = "~/dev/";
+const defaultRepoPaths = ["~/dev/"];
 
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-const insertCheckoutEntry = (source, ownerRepo) => {
+const parseConfigText = (source) => {
+  if (source.trim() === "") return {};
   let parsed;
-  if (source.trim() === "") {
-    parsed = {};
-  } else {
-    try {
-      parsed = JSON.parse(source);
-    } catch {
-      return null;
-    }
+  try {
+    parsed = JSON.parse(source);
+  } catch {
+    return null;
   }
-  if (!isRecord(parsed)) return null;
+  return isRecord(parsed) ? parsed : null;
+};
+const stringifyConfig = (config) => `${JSON.stringify(config, null, 2)}
+`;
+
+const repoPathsKeys = /* @__PURE__ */ new Set(["repoPaths", "defaultRepoPath"]);
+const isStringArray = (value) => Array.isArray(value) && value.every((item) => typeof item === "string");
+const readRepoPathsSetting = (source) => {
+  const config = parseConfigText(source);
+  if (config === null) return void 0;
+  if (isStringArray(config.repoPaths)) return config.repoPaths;
+  if (typeof config.defaultRepoPath === "string") {
+    return [config.defaultRepoPath];
+  }
+  return void 0;
+};
+const writeRepoPathsSetting = (source, paths) => {
+  const config = parseConfigText(source);
+  if (config === null) return null;
+  const repoPaths = [
+    ...new Set(paths.map((path) => path.trim()).filter((path) => path !== ""))
+  ];
+  const entries = Object.entries(config);
+  const at = entries.findIndex(([key]) => repoPathsKeys.has(key));
+  const others = entries.filter(([key]) => !repoPathsKeys.has(key));
+  others.splice(Math.max(at, 0), 0, ["repoPaths", repoPaths]);
+  return stringifyConfig(Object.fromEntries(others));
+};
+
+const insertCheckoutEntry = (source, ownerRepo) => {
+  const parsed = parseConfigText(source);
+  if (parsed === null) return null;
   const repos = parsed.repos ?? {};
   if (!isRecord(repos)) return null;
   const wanted = ownerRepo.toLowerCase();
@@ -3511,8 +3699,7 @@ const insertCheckoutEntry = (source, ownerRepo) => {
   );
   const key = existing ?? ownerRepo;
   const next = existing === void 0 ? { ...repos, [key]: "" } : repos;
-  const text = `${JSON.stringify({ ...parsed, repos: next }, null, 2)}
-`;
+  const text = stringifyConfig({ ...parsed, repos: next });
   const marker = `${JSON.stringify(key)}: "`;
   const reposAt = text.indexOf('\n  "repos": ');
   const at = text.indexOf(marker, reposAt);
@@ -3521,5 +3708,5 @@ const insertCheckoutEntry = (source, ownerRepo) => {
   return { source: text, cursor: value };
 };
 
-export { accountOfOwnerRepo, applyPullRequestEdit, applyStreamEvent, applySuggestionsToText, assembleBoard, boardReadDelayMs, buildPrQuery, changedPullRequestParts, checkOutcomes, checksFromReviewflow, coAuthorTrailers, commitSuggestions, createGitHubTransport, createReviewflowClient, createReviewflowFollower, defaultDiffFont, defaultDiffTheme, defaultRepoPath, diffFontOptions, diffLines, diffPaths, diffThemeNames, diffThemeOptions, diffThemes, editPullRequest, fail, fetchCompareDiff, fetchPullRequestCandidates, fetchPullRequestHead, fetchPullRequestPart, fetchPullRequestRevisions, formatPrChanges, formatRelativeDate, insertCheckoutEntry, interpretGraphql, isAttachablePath, isDiffFont, isDiffTheme, isDiffWhitespace, isPullRequestOnBoard, isPullRequestPart, isPullRequestReactionContent, isReviewflowFailure, lingerMs, maxExtraPagesPerBucket, maxFailedCheckNames, maxLookupTargets, maxRetryMs, parsePrQueryResponse, parsePullRequestCandidates, parsePullRequestChecks, parsePullRequestCommits, parsePullRequestDetail, parsePullRequestEdit, parsePullRequestFiles, parsePullRequestRevisions, parsePullRequestTimeline, parseSuggestions, partFingerprint, planSuggestions, pluralOf, prFields, prHasConflicts, prNumberOf, prStatus, prStatusLabels, prStatuses, prUrl, pullRequestCandidatesQuery, pullRequestChecksQuery, pullRequestCommitsQuery, pullRequestDetailQuery, pullRequestEditMovesBoard, pullRequestFilesQuery, pullRequestHeadQuery, pullRequestParts, pullRequestPartsStaleAfter, pullRequestReactionContents, pullRequestRevisionsQuery, pullRequestTimelineQuery, readAccountBoards, readPrDetail, readReviewflowStream, reconnectDelayMs, responseFailure, restErrorMessage, reviewflowErrorCode, reviewflowPrChangesRequested, reviewflowPrFailure, reviewflowPrFlowDate, reviewflowPrOwners, reviewflowPrProgress, reviewflowPrStatus, reviewflowReviewDecisions, splitOwnerRepo, streamClosedWithinDays, streamIdleTimeoutMs, subjectsOf, suggestionCommitRefusal, suggestionOriginalLines, suggestionRangesOverlap, toBoardPr, toFetchedPr, withAccountBoard, withFileViewed };
+export { accountOfOwnerRepo, applyPullRequestEdit, applyStreamEvent, applySuggestionsToText, assembleBoard, boardReadDelayMs, buildPrQuery, changedPullRequestParts, checkOutcomes, checksFromReviewflow, coAuthorTrailers, commitSuggestions, createGitHubTransport, createReviewflowClient, createReviewflowFollower, defaultDiffFont, defaultDiffTheme, defaultRepoPaths, diffFontOptions, diffLines, diffPaths, diffThemeNames, diffThemeOptions, diffThemes, dirtyRefusal, editPullRequest, fail, fetchBranchPullRequestHeads, fetchCompareDiff, fetchOpenPullRequests, fetchPullRequestCandidates, fetchPullRequestHead, fetchPullRequestPart, fetchPullRequestRevisions, formatPrChanges, formatRelativeDate, insertCheckoutEntry, interpretGraphql, isAttachablePath, isBranchDiffScope, isDiffFont, isDiffTheme, isDiffWhitespace, isPullRequestOnBoard, isPullRequestPart, isPullRequestReactionContent, isReviewflowFailure, lingerMs, lockRefusal, mainWorktreeRefusal, maxExtraPagesPerBucket, maxFailedCheckNames, maxLookupTargets, maxRetryMs, parseBranchPullRequestHeads, parseOpenPullRequests, parsePrQueryResponse, parsePullRequestCandidates, parsePullRequestChecks, parsePullRequestCommits, parsePullRequestDetail, parsePullRequestEdit, parsePullRequestFiles, parsePullRequestRevisions, parsePullRequestTimeline, parseSuggestions, partFingerprint, planSuggestions, pluralOf, prFields, prHasConflicts, prNumberOf, prStatus, prStatusLabels, prStatuses, prUrl, processesRefusal, pullRefusal, pullRequestCandidatesQuery, pullRequestChecksQuery, pullRequestCommitsQuery, pullRequestDetailQuery, pullRequestEditMovesBoard, pullRequestFilesQuery, pullRequestHeadQuery, pullRequestOfBranch, pullRequestParts, pullRequestPartsStaleAfter, pullRequestReactionContents, pullRequestRevisionsQuery, pullRequestTimelineQuery, pullRequestsWithoutBranch, pushRefusal, readAccountBoards, readPrDetail, readRepoPathsSetting, readReviewflowStream, reconnectDelayMs, responseFailure, restErrorMessage, reviewflowErrorCode, reviewflowPrChangesRequested, reviewflowPrFailure, reviewflowPrFlowDate, reviewflowPrOwners, reviewflowPrProgress, reviewflowPrStatus, reviewflowReviewDecisions, splitOwnerRepo, streamClosedWithinDays, streamIdleTimeoutMs, subjectsOf, suggestionCommitRefusal, suggestionOriginalLines, suggestionRangesOverlap, toBoardPr, toFetchedPr, unpushedRefusal, withAccountBoard, withFileViewed, worktreeRemovalRefusal, worktreeRemovalRefusals, writeRepoPathsSetting };
 //# sourceMappingURL=index-browser.es.js.map

package/build/index-node.mjs

@@ -1,3 +1,77 @@
+const sameRepo = (left, right) => left !== null && left.toLowerCase() === right.toLowerCase();
+const pullRequestOfBranch = (pullRequests, ownerRepo, branch) => pullRequests.find(
+  (pullRequest) => pullRequest.headRefName === branch && sameRepo(pullRequest.headOwnerRepo, ownerRepo)
+) ?? null;
+const pullRequestsWithoutBranch = (pullRequests, ownerRepo, branches) => {
+  const names = new Set(branches.map(({ name }) => name));
+  return pullRequests.filter(
+    (pullRequest) => !names.has(pullRequest.headRefName) || !sameRepo(pullRequest.headOwnerRepo, ownerRepo)
+  );
+};
+
+const upstreamGone = (upstream) => `${upstream} no longer exists on the remote`;
+const pullRefusal = (status) => {
+  if (status.branch === null) return "a detached HEAD has nothing to pull into";
+  if (status.upstream === null) {
+    return `${status.branch} tracks no remote branch`;
+  }
+  if (status.behind === null) return upstreamGone(status.upstream);
+  if (status.behind === 0) {
+    return `${status.branch} is not behind ${status.upstream}`;
+  }
+  return null;
+};
+const pushRefusal = (status, hasOrigin) => {
+  if (status.branch === null) return "a detached HEAD has no branch to push";
+  if (status.upstream === null) {
+    return hasOrigin ? null : "this repository has no origin remote";
+  }
+  if (status.ahead === null) return upstreamGone(status.upstream);
+  if (status.ahead === 0) {
+    return `${status.branch} has nothing to push to ${status.upstream}`;
+  }
+  return null;
+};
+
+const fileCount = (count, kind) => count === 0 ? null : `${String(count)} ${kind} file${count === 1 ? "" : "s"}`;
+const mainWorktreeRefusal = "This is the main checkout, which holds the repository: it is never removed.";
+const dirtyRefusal = ({
+  modified,
+  untracked
+}) => {
+  const parts = [
+    fileCount(modified, "modified"),
+    fileCount(untracked, "untracked")
+  ].filter((part) => part !== null);
+  if (parts.length === 0) return null;
+  return `${parts.join(" and ")}: git would refuse to remove this worktree. Commit or discard them first.`;
+};
+const unpushedRefusal = (count) => {
+  if (count === 0) return null;
+  const subject = count === 1 ? "1 commit exists" : `${String(count)} commits exist`;
+  return `${subject} only in this clone, on no remote branch and in no pull request. Push them first.`;
+};
+const lockRefusal = (lock) => {
+  if (lock === null) return null;
+  const reason = lock === "" ? "" : ` (${lock})`;
+  return `git holds this worktree locked${reason}, usually by a Claude Code process still running in it. Exit it first.`;
+};
+const processesRefusal = (count) => {
+  if (count === null || count === 0) return null;
+  const subject = count === 1 ? "1 process runs" : `${String(count)} processes run`;
+  return `${subject} inside this worktree (a shell, an editor or an agent): removing it would pull the directory out from under them. Exit them first.`;
+};
+const worktreeRemovalRefusals = (status) => {
+  if (status.main) return [mainWorktreeRefusal];
+  return [
+    dirtyRefusal(status),
+    unpushedRefusal(status.unpushedCommits),
+    lockRefusal(status.lock),
+    processesRefusal(status.processesInside)
+  ].filter((refusal) => refusal !== null);
+};
+const worktreeRemovalRefusal = (status) => worktreeRemovalRefusals(status)[0] ?? null;
+
 const cEscapes = {
   a: 7,
   b: 8,
@@ -196,6 +270,7 @@ const diffFontOptions = [
 ];
 
 const isDiffWhitespace = (value) => value === "hide" || value === "show";
+const isBranchDiffScope = (value) => value === "committed" || value === "uncommitted";
 
 const fenceOpen = /^( {0,3})(`{3,}(?!`)|~{3,}(?!~))(.*)$/;
 const withoutIndent = (line, indent) => {
@@ -669,7 +744,7 @@ const pullRequestReactionContents = [
 ];
 const isPullRequestReactionContent = (value) => pullRequestReactionContents.includes(value);
 
-const isStringArray = (value) => Array.isArray(value) && value.every((item) => typeof item === "string");
+const isStringArray$1 = (value) => Array.isArray(value) && value.every((item) => typeof item === "string");
 const isNonEmptyString = (value) => typeof value === "string" && value.trim() !== "";
 const isPositiveInteger = (value) => typeof value === "number" && Number.isInteger(value) && value > 0;
 const isSha = (value) => typeof value === "string" && /^[\da-f]{40}$/i.test(value);
@@ -794,13 +869,13 @@ const parsePullRequestEdit = (value) => {
       return { kind: "title", title: edit.title.trim() };
     }
     case "labels": {
-      if (!isStringArray(edit.add) || !isStringArray(edit.remove)) {
+      if (!isStringArray$1(edit.add) || !isStringArray$1(edit.remove)) {
         return "labels take add and remove, arrays of names";
       }
       return { kind: "labels", add: edit.add, remove: edit.remove };
     }
     case "reviewers": {
-      if (!isStringArray(edit.add) || !isStringArray(edit.remove) || !isStringArray(edit.addTeams) || !isStringArray(edit.removeTeams)) {
+      if (!isStringArray$1(edit.add) || !isStringArray$1(edit.remove) || !isStringArray$1(edit.addTeams) || !isStringArray$1(edit.removeTeams)) {
         return "reviewers take add, remove, addTeams and removeTeams, arrays of logins and team slugs";
       }
       return {
@@ -816,7 +891,7 @@ const parsePullRequestEdit = (value) => {
       return { kind: "draft", draft: edit.draft };
     }
     case "assignees": {
-      if (!isStringArray(edit.add) || !isStringArray(edit.remove)) {
+      if (!isStringArray$1(edit.add) || !isStringArray$1(edit.remove)) {
         return "assignees take add and remove, arrays of logins";
       }
       return { kind: "assignees", add: edit.add, remove: edit.remove };
@@ -1376,6 +1451,91 @@ const diffLines = ({
   ];
 };
 
+const openPullRequestsLimit = 100;
+const openPullRequestsQuery = `query OpenPullRequests($owner: String!, $name: String!, $first: Int!) {
+  repository(owner: $owner, name: $name) {
+    pullRequests(states: OPEN, first: $first, orderBy: { field: UPDATED_AT, direction: DESC }) {
+      totalCount
+      nodes {
+        number
+        title
+        isDraft
+        updatedAt
+        headRefName
+        headRepository { nameWithOwner }
+        author { login }
+      }
+    }
+  }
+}`;
+const parseOpenPullRequests = ({
+  data,
+  errors
+}) => {
+  const connection = data?.repository?.pullRequests ?? null;
+  if (connection === null) {
+    throw new Error(errors.length > 0 ? errors.join("; ") : "not found");
+  }
+  const pullRequests = (connection.nodes ?? []).filter((node) => node !== null).map((node) => ({
+    number: node.number,
+    title: node.title,
+    isDraft: node.isDraft,
+    headRefName: node.headRefName,
+    headOwnerRepo: node.headRepository?.nameWithOwner ?? null,
+    author: node.author?.login ?? null,
+    updatedAt: node.updatedAt
+  }));
+  return { pullRequests, totalCount: connection.totalCount };
+};
+const fetchOpenPullRequests = async (transport, ownerRepo) => {
+  const split = splitOwnerRepo(ownerRepo);
+  if (split === null) throw new Error(`${ownerRepo} is not owner/repo`);
+  return parseOpenPullRequests(
+    await transport.graphql(openPullRequestsQuery, {
+      owner: split.owner,
+      name: split.name,
+      first: openPullRequestsLimit
+    })
+  );
+};
+const branchPullRequestsQuery = `query BranchPullRequests($owner: String!, $name: String!, $branch: String!) {
+  repository(owner: $owner, name: $name) {
+    pullRequests(headRefName: $branch, first: 20, orderBy: { field: UPDATED_AT, direction: DESC }) {
+      nodes {
+        number
+        state
+        headRefOid
+        headRepository { nameWithOwner }
+      }
+    }
+  }
+}`;
+const parseBranchPullRequestHeads = ({ data, errors }, ownerRepo) => {
+  const connection = data?.repository?.pullRequests ?? null;
+  if (connection === null) {
+    throw new Error(errors.length > 0 ? errors.join("; ") : "not found");
+  }
+  return (connection.nodes ?? []).filter((node) => node !== null).filter(
+    (node) => node.headRepository?.nameWithOwner.toLowerCase() === ownerRepo.toLowerCase()
+  ).map(({ number, state, headRefOid }) => ({
+    number,
+    state,
+    sha: headRefOid
+  }));
+};
+const fetchBranchPullRequestHeads = async (transport, ownerRepo, branch) => {
+  const split = splitOwnerRepo(ownerRepo);
+  if (split === null) throw new Error(`${ownerRepo} is not owner/repo`);
+  return parseBranchPullRequestHeads(
+    await transport.graphql(branchPullRequestsQuery, {
+      owner: split.owner,
+      name: split.name,
+      branch
+    }),
+    ownerRepo
+  );
+};
+
 const imgTag = /<img\b[^>]*>/gi;
 const decodeAttribute = (value) => value.replaceAll("&quot;", '"').replaceAll("&#39;", "'").replaceAll("&lt;", "<").replaceAll("&gt;", ">").replaceAll("&amp;", "&");
 const attribute = (tag, name) => {
@@ -3488,21 +3648,49 @@ const createReviewflowFollower = ({
   };
 };
 
-const defaultRepoPath = "~/dev/";
+const defaultRepoPaths = ["~/dev/"];
 
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-const insertCheckoutEntry = (source, ownerRepo) => {
+const parseConfigText = (source) => {
+  if (source.trim() === "") return {};
   let parsed;
-  if (source.trim() === "") {
-    parsed = {};
-  } else {
-    try {
-      parsed = JSON.parse(source);
-    } catch {
-      return null;
-    }
+  try {
+    parsed = JSON.parse(source);
+  } catch {
+    return null;
   }
-  if (!isRecord(parsed)) return null;
+  return isRecord(parsed) ? parsed : null;
+};
+const stringifyConfig = (config) => `${JSON.stringify(config, null, 2)}
+`;
+
+const repoPathsKeys = /* @__PURE__ */ new Set(["repoPaths", "defaultRepoPath"]);
+const isStringArray = (value) => Array.isArray(value) && value.every((item) => typeof item === "string");
+const readRepoPathsSetting = (source) => {
+  const config = parseConfigText(source);
+  if (config === null) return void 0;
+  if (isStringArray(config.repoPaths)) return config.repoPaths;
+  if (typeof config.defaultRepoPath === "string") {
+    return [config.defaultRepoPath];
+  }
+  return void 0;
+};
+const writeRepoPathsSetting = (source, paths) => {
+  const config = parseConfigText(source);
+  if (config === null) return null;
+  const repoPaths = [
+    ...new Set(paths.map((path) => path.trim()).filter((path) => path !== ""))
+  ];
+  const entries = Object.entries(config);
+  const at = entries.findIndex(([key]) => repoPathsKeys.has(key));
+  const others = entries.filter(([key]) => !repoPathsKeys.has(key));
+  others.splice(Math.max(at, 0), 0, ["repoPaths", repoPaths]);
+  return stringifyConfig(Object.fromEntries(others));
+};
+
+const insertCheckoutEntry = (source, ownerRepo) => {
+  const parsed = parseConfigText(source);
+  if (parsed === null) return null;
   const repos = parsed.repos ?? {};
   if (!isRecord(repos)) return null;
   const wanted = ownerRepo.toLowerCase();
@@ -3511,8 +3699,7 @@ const insertCheckoutEntry = (source, ownerRepo) => {
   );
   const key = existing ?? ownerRepo;
   const next = existing === void 0 ? { ...repos, [key]: "" } : repos;
-  const text = `${JSON.stringify({ ...parsed, repos: next }, null, 2)}
-`;
+  const text = stringifyConfig({ ...parsed, repos: next });
   const marker = `${JSON.stringify(key)}: "`;
   const reposAt = text.indexOf('\n  "repos": ');
   const at = text.indexOf(marker, reposAt);
@@ -3521,5 +3708,5 @@ const insertCheckoutEntry = (source, ownerRepo) => {
   return { source: text, cursor: value };
 };
 
-export { accountOfOwnerRepo, applyPullRequestEdit, applyStreamEvent, applySuggestionsToText, assembleBoard, boardReadDelayMs, buildPrQuery, changedPullRequestParts, checkOutcomes, checksFromReviewflow, coAuthorTrailers, commitSuggestions, createGitHubTransport, createReviewflowClient, createReviewflowFollower, defaultDiffFont, defaultDiffTheme, defaultRepoPath, diffFontOptions, diffLines, diffPaths, diffThemeNames, diffThemeOptions, diffThemes, editPullRequest, fail, fetchCompareDiff, fetchPullRequestCandidates, fetchPullRequestHead, fetchPullRequestPart, fetchPullRequestRevisions, formatPrChanges, formatRelativeDate, insertCheckoutEntry, interpretGraphql, isAttachablePath, isDiffFont, isDiffTheme, isDiffWhitespace, isPullRequestOnBoard, isPullRequestPart, isPullRequestReactionContent, isReviewflowFailure, lingerMs, maxExtraPagesPerBucket, maxFailedCheckNames, maxLookupTargets, maxRetryMs, parsePrQueryResponse, parsePullRequestCandidates, parsePullRequestChecks, parsePullRequestCommits, parsePullRequestDetail, parsePullRequestEdit, parsePullRequestFiles, parsePullRequestRevisions, parsePullRequestTimeline, parseSuggestions, partFingerprint, planSuggestions, pluralOf, prFields, prHasConflicts, prNumberOf, prStatus, prStatusLabels, prStatuses, prUrl, pullRequestCandidatesQuery, pullRequestChecksQuery, pullRequestCommitsQuery, pullRequestDetailQuery, pullRequestEditMovesBoard, pullRequestFilesQuery, pullRequestHeadQuery, pullRequestParts, pullRequestPartsStaleAfter, pullRequestReactionContents, pullRequestRevisionsQuery, pullRequestTimelineQuery, readAccountBoards, readPrDetail, readReviewflowStream, reconnectDelayMs, responseFailure, restErrorMessage, reviewflowErrorCode, reviewflowPrChangesRequested, reviewflowPrFailure, reviewflowPrFlowDate, reviewflowPrOwners, reviewflowPrProgress, reviewflowPrStatus, reviewflowReviewDecisions, splitOwnerRepo, streamClosedWithinDays, streamIdleTimeoutMs, subjectsOf, suggestionCommitRefusal, suggestionOriginalLines, suggestionRangesOverlap, toBoardPr, toFetchedPr, withAccountBoard, withFileViewed };
+export { accountOfOwnerRepo, applyPullRequestEdit, applyStreamEvent, applySuggestionsToText, assembleBoard, boardReadDelayMs, buildPrQuery, changedPullRequestParts, checkOutcomes, checksFromReviewflow, coAuthorTrailers, commitSuggestions, createGitHubTransport, createReviewflowClient, createReviewflowFollower, defaultDiffFont, defaultDiffTheme, defaultRepoPaths, diffFontOptions, diffLines, diffPaths, diffThemeNames, diffThemeOptions, diffThemes, dirtyRefusal, editPullRequest, fail, fetchBranchPullRequestHeads, fetchCompareDiff, fetchOpenPullRequests, fetchPullRequestCandidates, fetchPullRequestHead, fetchPullRequestPart, fetchPullRequestRevisions, formatPrChanges, formatRelativeDate, insertCheckoutEntry, interpretGraphql, isAttachablePath, isBranchDiffScope, isDiffFont, isDiffTheme, isDiffWhitespace, isPullRequestOnBoard, isPullRequestPart, isPullRequestReactionContent, isReviewflowFailure, lingerMs, lockRefusal, mainWorktreeRefusal, maxExtraPagesPerBucket, maxFailedCheckNames, maxLookupTargets, maxRetryMs, parseBranchPullRequestHeads, parseOpenPullRequests, parsePrQueryResponse, parsePullRequestCandidates, parsePullRequestChecks, parsePullRequestCommits, parsePullRequestDetail, parsePullRequestEdit, parsePullRequestFiles, parsePullRequestRevisions, parsePullRequestTimeline, parseSuggestions, partFingerprint, planSuggestions, pluralOf, prFields, prHasConflicts, prNumberOf, prStatus, prStatusLabels, prStatuses, prUrl, processesRefusal, pullRefusal, pullRequestCandidatesQuery, pullRequestChecksQuery, pullRequestCommitsQuery, pullRequestDetailQuery, pullRequestEditMovesBoard, pullRequestFilesQuery, pullRequestHeadQuery, pullRequestOfBranch, pullRequestParts, pullRequestPartsStaleAfter, pullRequestReactionContents, pullRequestRevisionsQuery, pullRequestTimelineQuery, pullRequestsWithoutBranch, pushRefusal, readAccountBoards, readPrDetail, readRepoPathsSetting, readReviewflowStream, reconnectDelayMs, responseFailure, restErrorMessage, reviewflowErrorCode, reviewflowPrChangesRequested, reviewflowPrFailure, reviewflowPrFlowDate, reviewflowPrOwners, reviewflowPrProgress, reviewflowPrStatus, reviewflowReviewDecisions, splitOwnerRepo, streamClosedWithinDays, streamIdleTimeoutMs, subjectsOf, suggestionCommitRefusal, suggestionOriginalLines, suggestionRangesOverlap, toBoardPr, toFetchedPr, unpushedRefusal, withAccountBoard, withFileViewed, worktreeRemovalRefusal, worktreeRemovalRefusals, writeRepoPathsSetting };
 //# sourceMappingURL=index-node.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reviewflow/sdk",
-  "version": "6.25.0",
+  "version": "6.27.0",
   "description": "pull request model shared by the reviewflow app server and its ui: diff and api types, pure utils, the GitHub layer behind an injected transport, and (node only) reading a diff from a local checkout (@reviewflow/sdk/git) and editing a text file in place (@reviewflow/sdk/files)",
   "keywords": [
     "code-review",